x-twitter-scraper 0.5.4 → 0.6.0

data/rbi/x_twitter_scraper/models/x/user_retrieve_likes_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_media_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_mentions_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_replies_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_search_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_tweets_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/user_retrieve_verified_followers_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/users/follow_create_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/users/follow_create_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/users/follow_delete_all_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/users/follow_delete_all_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/write_action_retrieve_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/write_action_retrieve_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x/x_account.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper
@@ -20,11 +24,11 @@ module XTwitterScraper
         sig { returns(Time) }
         attr_accessor :created_at
 
-        # Derived connection health. `healthy` = session active. `needsReauth` = user must
+        # Derived connection health. `healthy` = ready to use. `needsReauth` = user must
         # submit fresh credentials. `locked` = X locked the account; unlock on x.com
-        # first. `suspended` = X banned the account. `recovering` = past cooldown, will
-        # auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-        # shortly.
+        # first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+        # account can reconnect on its next use. `temporaryIssue` = temporary connection
+        # problem; wait before the next use.
         sig { returns(XTwitterScraper::X::XAccount::Health::TaggedSymbol) }
         attr_accessor :health
 
@@ -62,11 +66,11 @@ module XTwitterScraper
         def self.new(
           id:,
           created_at:,
-          # Derived connection health. `healthy` = session active. `needsReauth` = user must
+          # Derived connection health. `healthy` = ready to use. `needsReauth` = user must
           # submit fresh credentials. `locked` = X locked the account; unlock on x.com
-          # first. `suspended` = X banned the account. `recovering` = past cooldown, will
-          # auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-          # shortly.
+          # first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+          # account can reconnect on its next use. `temporaryIssue` = temporary connection
+          # problem; wait before the next use.
           health:,
           status:,
           updated_at:,
@@ -93,11 +97,11 @@ module XTwitterScraper
         def to_hash
         end
 
-        # Derived connection health. `healthy` = session active. `needsReauth` = user must
+        # Derived connection health. `healthy` = ready to use. `needsReauth` = user must
         # submit fresh credentials. `locked` = X locked the account; unlock on x.com
-        # first. `suspended` = X banned the account. `recovering` = past cooldown, will
-        # auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-        # shortly.
+        # first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+        # account can reconnect on its next use. `temporaryIssue` = temporary connection
+        # problem; wait before the next use.
         module Health
           extend XTwitterScraper::Internal::Type::Enum
 

data/rbi/x_twitter_scraper/models/x/x_account_detail.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_article_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_article_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_home_timeline_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_notifications_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_notifications_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_trends_params.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models/x_get_trends_response.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/models.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/request_options.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/account.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/compose.rbi

@@ -1,13 +1,17 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper
   module Resources
     # AI tweet composition, drafts, writing styles, and radar
     class Compose
-      # Run one step of Xquik's three-step writing workflow. Compose returns questions
-      # and editorial rules. Refine returns goal-specific guidance. Score applies
-      # deterministic text checks. It does not predict reach or expose X ranking
-      # weights.
+      # Run one step of Xquik's three-step writing workflow. Compose returns questions,
+      # editorial rules, and source-specific Radar recommendations. Refine returns
+      # goal-specific guidance. Score applies deterministic text checks. It does not
+      # predict reach or expose X ranking weights.
       sig do
         params(
           body:

data/rbi/x_twitter_scraper/resources/credits.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/drafts.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/draws.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/events.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/extractions.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/guest_wallets.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/monitors/keywords.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/monitors.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/radar.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/styles.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/subscribe.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/support/tickets.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/support.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/trends.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/webhooks.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/account_connection_attempts.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module XTwitterScraper
+  module Resources
+    class X
+      # Connected X account management
+      class AccountConnectionAttempts
+        # Get X account connection status
+        sig do
+          params(
+            id: String,
+            request_options: XTwitterScraper::RequestOptions::OrHash
+          ).returns(
+            XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::Variants
+          )
+        end
+        def retrieve(
+          # Connection attempt ID returned by `POST /x/accounts`.
+          id,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig do
+          params(client: XTwitterScraper::Client).returns(T.attached_class)
+        end
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/resources/x/account_connection_challenges.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/accounts.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper
@@ -10,20 +14,20 @@ module XTwitterScraper
           params(
             email: String,
             password: String,
-            username: String,
             totp_secret: String,
+            username: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
-          ).returns(XTwitterScraper::Models::X::AccountCreateResponse)
+          ).returns(T.anything)
         end
         def create(
           # Account email
           email:,
           # Account password
           password:,
+          # Authenticator App TOTP secret required for durable login
+          totp_secret:,
           # X username
           username:,
-          # TOTP secret for 2FA
-          totp_secret: nil,
           request_options: {}
         )
         end
@@ -92,7 +96,7 @@ module XTwitterScraper
           password:,
           # Email for the X account (updates stored email)
           email: nil,
-          # TOTP secret for 2FA re-authentication
+          # Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
           totp_secret: nil,
           request_options: {}
         )

data/rbi/x_twitter_scraper/resources/x/bookmarks.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/communities/join.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/communities/tweets.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/communities.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/dm.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/followers.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/lists.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/media.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/profile.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/tweets/like.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/tweets/retweet.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/tweets.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/users/follow.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper

data/rbi/x_twitter_scraper/resources/x/users.rbi

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Xquik contributors
+#
+# SPDX-License-Identifier: Apache-2.0
+
 # typed: strong
 
 module XTwitterScraper