x-twitter-scraper 0.4.5 → 0.5.2

data/lib/x_twitter_scraper/models/compose_create_response.rb

@@ -3,39 +3,332 @@
 module XTwitterScraper
   module Models
     # @see XTwitterScraper::Resources::Compose#create
-    class ComposeCreateResponse < XTwitterScraper::Internal::Type::BaseModel
-      # @!attribute feedback
-      #   AI feedback on the draft
-      #
-      #   @return [String, nil]
-      optional :feedback, String
-
-      # @!attribute score
-      #   Engagement score (0-100)
-      #
-      #   @return [Float, nil]
-      optional :score, Float
-
-      # @!attribute suggestions
-      #   Improvement suggestions
-      #
-      #   @return [Array<String>, nil]
-      optional :suggestions, XTwitterScraper::Internal::Type::ArrayOf[String]
-
-      # @!attribute text
-      #   Generated or refined tweet text
-      #
-      #   @return [String, nil]
-      optional :text, String
-
-      # @!method initialize(feedback: nil, score: nil, suggestions: nil, text: nil)
-      #   @param feedback [String] AI feedback on the draft
-      #
-      #   @param score [Float] Engagement score (0-100)
-      #
-      #   @param suggestions [Array<String>] Improvement suggestions
-      #
-      #   @param text [String] Generated or refined tweet text
+    module ComposeCreateResponse
+      extend XTwitterScraper::Internal::Type::Union
+
+      variant -> { XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult }
+
+      variant -> { XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult }
+
+      variant -> { XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult }
+
+      class ComposePrepareResult < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute content_rules
+        #   Xquik editorial heuristics, ordered for the goal.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ContentRule>]
+        required :content_rules,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ContentRule] },
+                 api_name: :contentRules
+
+        # @!attribute engagement_multipliers
+        #   Published engagement signal names. Production multipliers are not published.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::EngagementMultiplier>]
+        required :engagement_multipliers,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::EngagementMultiplier] },
+                 api_name: :engagementMultipliers
+
+        # @!attribute engagement_velocity
+        #   Publication limit for timing and decay claims.
+        #
+        #   @return [String]
+        required :engagement_velocity, String, api_name: :engagementVelocity
+
+        # @!attribute follow_up_questions
+        #
+        #   @return [Array<String>]
+        required :follow_up_questions,
+                 XTwitterScraper::Internal::Type::ArrayOf[String],
+                 api_name: :followUpQuestions
+
+        # @!attribute intent_url
+        #   X post intent seeded with the topic.
+        #
+        #   @return [String]
+        required :intent_url, String, api_name: :intentUrl
+
+        # @!attribute next_step
+        #
+        #   @return [String]
+        required :next_step, String, api_name: :nextStep
+
+        # @!attribute scorer_weights
+        #   Published signal names with unpublished weights as null.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ScorerWeight>]
+        required :scorer_weights,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ScorerWeight] },
+                 api_name: :scorerWeights
+
+        # @!attribute source
+        #   Signal source and evidence limits.
+        #
+        #   @return [String]
+        required :source, String
+
+        # @!attribute top_penalties
+        #   Negative engagement predictions in the public model.
+        #
+        #   @return [Array<String>]
+        required :top_penalties, XTwitterScraper::Internal::Type::ArrayOf[String], api_name: :topPenalties
+
+        # @!attribute saved_styles
+        #   Style analyses saved to the account.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::SavedStyle>, nil]
+        optional :saved_styles,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::SavedStyle] },
+                 api_name: :savedStyles
+
+        # @!attribute style_note
+        #   Next action when no cached style is available.
+        #
+        #   @return [String, nil]
+        optional :style_note, String, api_name: :styleNote
+
+        # @!attribute style_tweets
+        #   Cached examples for the requested style username.
+        #
+        #   @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)
+        #   Some parameter documentations has been truncated, see
+        #   {XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult} for more
+        #   details.
+        #
+        #   @param content_rules [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ContentRule>] Xquik editorial heuristics, ordered for the goal.
+        #
+        #   @param engagement_multipliers [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::EngagementMultiplier>] Published engagement signal names. Production multipliers are not published.
+        #
+        #   @param engagement_velocity [String] Publication limit for timing and decay claims.
+        #
+        #   @param follow_up_questions [Array<String>]
+        #
+        #   @param intent_url [String] X post intent seeded with the topic.
+        #
+        #   @param next_step [String]
+        #
+        #   @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.
+        #
+        #   @param top_penalties [Array<String>] Negative engagement predictions in the public model.
+        #
+        #   @param saved_styles [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::SavedStyle>] Style analyses saved to the account.
+        #
+        #   @param style_note [String] Next action when no cached style is available.
+        #
+        #   @param style_tweets [Array<String>] Cached examples for the requested style username.
+
+        class ContentRule < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute rule
+          #
+          #   @return [String]
+          required :rule, String
+
+          # @!method initialize(rule:)
+          #   @param rule [String]
+        end
+
+        class EngagementMultiplier < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute action
+          #   Human-readable published signal name.
+          #
+          #   @return [String]
+          required :action, String
+
+          # @!attribute multiplier
+          #
+          #   @return [Symbol, :"Production weight not published by X"]
+          required :multiplier, const: :"Production weight not published by X"
+
+          # @!method initialize(action:, multiplier: :"Production weight not published by X")
+          #   @param action [String] Human-readable published signal name.
+          #
+          #   @param multiplier [Symbol, :"Production weight not published by X"]
+        end
+
+        class ScorerWeight < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute context
+          #   Signal direction and publication limit.
+          #
+          #   @return [String]
+          required :context, String
+
+          # @!attribute signal
+          #   Signal name from X's public ranking repository.
+          #
+          #   @return [String]
+          required :signal, String
+
+          # @!attribute weight
+          #   X does not publish the production weight.
+          #
+          #   @return [nil]
+          required :weight, NilClass
+
+          # @!method initialize(context:, signal:, weight:)
+          #   @param context [String] Signal direction and publication limit.
+          #
+          #   @param signal [String] Signal name from X's public ranking repository.
+          #
+          #   @param weight [nil] X does not publish the production weight.
+        end
+
+        class SavedStyle < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute tweet_count
+          #
+          #   @return [Integer]
+          required :tweet_count, Integer, api_name: :tweetCount
+
+          # @!attribute username
+          #
+          #   @return [String]
+          required :username, String
+
+          # @!method initialize(tweet_count:, username:)
+          #   @param tweet_count [Integer]
+          #   @param username [String]
+        end
+      end
+
+      class ComposeRefineResult < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute composition_guidance
+        #   Goal, tone, media, and editorial guidance.
+        #
+        #   @return [Array<String>]
+        required :composition_guidance,
+                 XTwitterScraper::Internal::Type::ArrayOf[String],
+                 api_name: :compositionGuidance
+
+        # @!attribute example_patterns
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult::ExamplePattern>]
+        required :example_patterns,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult::ExamplePattern] },
+                 api_name: :examplePatterns
+
+        # @!attribute intent_url
+        #   X post intent seeded with the topic.
+        #
+        #   @return [String]
+        required :intent_url, String, api_name: :intentUrl
+
+        # @!attribute next_step
+        #
+        #   @return [String]
+        required :next_step, String, api_name: :nextStep
+
+        # @!method initialize(composition_guidance:, example_patterns:, intent_url:, next_step:)
+        #   @param composition_guidance [Array<String>] Goal, tone, media, and editorial guidance.
+        #
+        #   @param example_patterns [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult::ExamplePattern>]
+        #
+        #   @param intent_url [String] X post intent seeded with the topic.
+        #
+        #   @param next_step [String]
+
+        class ExamplePattern < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute description
+          #
+          #   @return [String]
+          required :description, String
+
+          # @!attribute pattern
+          #
+          #   @return [String]
+          required :pattern, String
+
+          # @!method initialize(description:, pattern:)
+          #   @param description [String]
+          #   @param pattern [String]
+        end
+      end
+
+      class ComposeScoreResult < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute checklist
+        #   Deterministic editorial checks. Not a reach prediction.
+        #
+        #   @return [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult::Checklist>]
+        required :checklist,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult::Checklist] }
+
+        # @!attribute next_step
+        #
+        #   @return [String]
+        required :next_step, String, api_name: :nextStep
+
+        # @!attribute passed
+        #
+        #   @return [Boolean]
+        required :passed, XTwitterScraper::Internal::Type::Boolean
+
+        # @!attribute passed_count
+        #
+        #   @return [Integer]
+        required :passed_count, Integer, api_name: :passedCount
+
+        # @!attribute top_suggestion
+        #
+        #   @return [String]
+        required :top_suggestion, String, api_name: :topSuggestion
+
+        # @!attribute total_checks
+        #
+        #   @return [Integer, 9]
+        required :total_checks, const: 9, api_name: :totalChecks
+
+        # @!attribute intent_url
+        #   Present only when every check passes.
+        #
+        #   @return [String, nil]
+        optional :intent_url, String, api_name: :intentUrl
+
+        # @!method initialize(checklist:, next_step:, passed:, passed_count:, top_suggestion:, intent_url: nil, total_checks: 9)
+        #   @param checklist [Array<XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult::Checklist>] Deterministic editorial checks. Not a reach prediction.
+        #
+        #   @param next_step [String]
+        #
+        #   @param passed [Boolean]
+        #
+        #   @param passed_count [Integer]
+        #
+        #   @param top_suggestion [String]
+        #
+        #   @param intent_url [String] Present only when every check passes.
+        #
+        #   @param total_checks [Integer, 9]
+
+        class Checklist < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute factor
+          #
+          #   @return [String]
+          required :factor, String
+
+          # @!attribute passed
+          #
+          #   @return [Boolean]
+          required :passed, XTwitterScraper::Internal::Type::Boolean
+
+          # @!attribute suggestion
+          #   Present only when the check fails.
+          #
+          #   @return [String, nil]
+          optional :suggestion, String
+
+          # @!method initialize(factor:, passed:, suggestion: nil)
+          #   @param factor [String]
+          #
+          #   @param passed [Boolean]
+          #
+          #   @param suggestion [String] Present only when the check fails.
+        end
+      end
+
+      # @!method self.variants
+      #   @return [Array(XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult, XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult, XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult)]
     end
   end
 end

data/lib/x_twitter_scraper/models/credit_retrieve_topup_status_params.rb

@@ -8,13 +8,13 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute session_id
-      #   Billing session ID returned by the top-up billing flow.
+      #   Top-up session ID to inspect.
       #
       #   @return [String]
       required :session_id, String
 
       # @!method initialize(session_id:, request_options: {})
-      #   @param session_id [String] Billing session ID returned by the top-up billing flow.
+      #   @param session_id [String] Top-up session ID to inspect.
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/x_twitter_scraper/models/error.rb

@@ -8,12 +8,44 @@ module XTwitterScraper
       #   @return [Symbol, XTwitterScraper::Models::Error::Error::LegacyErrorCode, XTwitterScraper::Models::Error::Error::StructuredError]
       required :error, union: -> { XTwitterScraper::Error::Error }
 
-      # @!method initialize(error:)
+      # @!attribute message
+      #   Human-readable error guidance.
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!attribute reason
+      #   Machine-readable reason for a login cooldown.
+      #
+      #   @return [String, nil]
+      optional :reason, String
+
+      # @!attribute retry_after
+      #   Seconds until the next permitted request.
+      #
+      #   @return [Integer, nil]
+      optional :retry_after, Integer, api_name: :retryAfter
+
+      # @!attribute retry_after_ms
+      #   Required wait in milliseconds.
+      #
+      #   @return [Integer, nil]
+      optional :retry_after_ms, Integer, api_name: :retryAfterMs
+
+      # @!method initialize(error:, message: nil, reason: nil, retry_after: nil, retry_after_ms: nil)
       #   Error response. Default v1 returns a legacy string error code. Send
       #   `xquik-api-contract: 2026-04-29` to receive the structured best-practice error
       #   object.
       #
       #   @param error [Symbol, XTwitterScraper::Models::Error::Error::LegacyErrorCode, XTwitterScraper::Models::Error::Error::StructuredError]
+      #
+      #   @param message [String] Human-readable error guidance.
+      #
+      #   @param reason [String] Machine-readable reason for a login cooldown.
+      #
+      #   @param retry_after [Integer] Seconds until the next permitted request.
+      #
+      #   @param retry_after_ms [Integer] Required wait in milliseconds.
 
       # @see XTwitterScraper::Models::Error#error
       module Error
@@ -66,6 +98,39 @@ module XTwitterScraper
           UNAUTHENTICATED = :unauthenticated
           UNSUPPORTED_FIELD = :unsupported_field
           USER_NOT_FOUND = :user_not_found
+          BODY_TOO_LARGE = :body_too_large
+          CHECKOUT_UNAVAILABLE = :checkout_unavailable
+          CONNECTION_CHALLENGE_EXPIRED = :connection_challenge_expired
+          CONNECTION_CHALLENGE_INACTIVE = :connection_challenge_inactive
+          DRAFT_NOT_FOUND = :draft_not_found
+          FAVORITERS_UNAVAILABLE = :favoriters_unavailable
+          FORBIDDEN = :forbidden
+          GUEST_WALLET_UNAVAILABLE = :guest_wallet_unavailable
+          GUEST_WALLETS_DISABLED = :guest_wallets_disabled
+          GUEST_WALLETS_UNAVAILABLE = :guest_wallets_unavailable
+          IDEMPOTENCY_CONFLICT = :idempotency_conflict
+          IDEMPOTENCY_KEY_CONFLICT = :idempotency_key_conflict
+          INVALID_COMMUNITY_ID = :invalid_community_id
+          INVALID_IDEMPOTENCY_KEY = :invalid_idempotency_key
+          INVALID_LIST_ID = :invalid_list_id
+          INVALID_PAYMENT_AMOUNT = :invalid_payment_amount
+          INVALID_RANGE = :invalid_range
+          LOGIN_RATE_LIMITED = :login_rate_limited
+          MISSING_IDEMPOTENCY_KEY = :missing_idempotency_key
+          MISSING_IDS = :missing_ids
+          NO_CACHED_STYLE = :no_cached_style
+          PASSKEY_REQUIRED = :passkey_required
+          RATE_LIMITED = :rate_limited
+          READ_REQUEST_TIMEOUT = :read_request_timeout
+          REPLIES_INCOMPLETE = :replies_incomplete
+          SUPPORT_MEDIA_RATE_LIMIT = :support_media_rate_limit
+          SUPPORT_REQUEST_RATE_LIMIT = :support_request_rate_limit
+          TOO_MANY_IDS = :too_many_ids
+          UNKNOWN_FIELD = :unknown_field
+          UNSUPPORTED_MEDIA_TYPE = :unsupported_media_type
+          WEBHOOK_INACTIVE = :webhook_inactive
+          WRITE_TRACKING_UNAVAILABLE = :write_tracking_unavailable
+          X_WRITE_UNCONFIRMED = :x_write_unconfirmed
           X_ACCOUNT_FEATURE_REQUIRED = :x_account_feature_required
           X_ACCOUNT_PROTECTED = :x_account_protected
           X_ACCOUNT_SUSPENDED = :x_account_suspended
@@ -92,7 +157,6 @@ module XTwitterScraper
           X_USER_LOOKUP_FAILED = :x_user_lookup_failed
           X_WRITE_AMBIGUOUS = :x_write_ambiguous
           X_WRITE_FAILED = :x_write_failed
-          X_WRITE_UNCONFIRMED = :x_write_unconfirmed
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -163,6 +227,39 @@ module XTwitterScraper
             UNAUTHENTICATED = :unauthenticated
             UNSUPPORTED_FIELD = :unsupported_field
             USER_NOT_FOUND = :user_not_found
+            BODY_TOO_LARGE = :body_too_large
+            CHECKOUT_UNAVAILABLE = :checkout_unavailable
+            CONNECTION_CHALLENGE_EXPIRED = :connection_challenge_expired
+            CONNECTION_CHALLENGE_INACTIVE = :connection_challenge_inactive
+            DRAFT_NOT_FOUND = :draft_not_found
+            FAVORITERS_UNAVAILABLE = :favoriters_unavailable
+            FORBIDDEN = :forbidden
+            GUEST_WALLET_UNAVAILABLE = :guest_wallet_unavailable
+            GUEST_WALLETS_DISABLED = :guest_wallets_disabled
+            GUEST_WALLETS_UNAVAILABLE = :guest_wallets_unavailable
+            IDEMPOTENCY_CONFLICT = :idempotency_conflict
+            IDEMPOTENCY_KEY_CONFLICT = :idempotency_key_conflict
+            INVALID_COMMUNITY_ID = :invalid_community_id
+            INVALID_IDEMPOTENCY_KEY = :invalid_idempotency_key
+            INVALID_LIST_ID = :invalid_list_id
+            INVALID_PAYMENT_AMOUNT = :invalid_payment_amount
+            INVALID_RANGE = :invalid_range
+            LOGIN_RATE_LIMITED = :login_rate_limited
+            MISSING_IDEMPOTENCY_KEY = :missing_idempotency_key
+            MISSING_IDS = :missing_ids
+            NO_CACHED_STYLE = :no_cached_style
+            PASSKEY_REQUIRED = :passkey_required
+            RATE_LIMITED = :rate_limited
+            READ_REQUEST_TIMEOUT = :read_request_timeout
+            REPLIES_INCOMPLETE = :replies_incomplete
+            SUPPORT_MEDIA_RATE_LIMIT = :support_media_rate_limit
+            SUPPORT_REQUEST_RATE_LIMIT = :support_request_rate_limit
+            TOO_MANY_IDS = :too_many_ids
+            UNKNOWN_FIELD = :unknown_field
+            UNSUPPORTED_MEDIA_TYPE = :unsupported_media_type
+            WEBHOOK_INACTIVE = :webhook_inactive
+            WRITE_TRACKING_UNAVAILABLE = :write_tracking_unavailable
+            X_WRITE_UNCONFIRMED = :x_write_unconfirmed
             X_ACCOUNT_FEATURE_REQUIRED = :x_account_feature_required
             X_ACCOUNT_PROTECTED = :x_account_protected
             X_ACCOUNT_SUSPENDED = :x_account_suspended
@@ -189,7 +286,6 @@ module XTwitterScraper
             X_USER_LOOKUP_FAILED = :x_user_lookup_failed
             X_WRITE_AMBIGUOUS = :x_write_ambiguous
             X_WRITE_FAILED = :x_write_failed
-            X_WRITE_UNCONFIRMED = :x_write_unconfirmed
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/x_twitter_scraper/models/extraction_estimate_cost_params.rb

@@ -185,7 +185,7 @@ module XTwitterScraper
       optional :retweets_of_tweet_id, String, api_name: :retweetsOfTweetId
 
       # @!attribute search_query
-      #   Required for tweet_search_extractor & community_search.
+      #   Query used to price tweet_search_extractor or community_search.
       #
       #   @return [String, nil]
       optional :search_query, String, api_name: :searchQuery
@@ -197,20 +197,20 @@ module XTwitterScraper
       optional :since_date, Date, api_name: :sinceDate
 
       # @!attribute target_community_id
-      #   Required for community_post_extractor & community_search.
+      #   Community ID used to price community_post_extractor or community_search.
       #
       #   @return [String, nil]
       optional :target_community_id, String, api_name: :targetCommunityId
 
       # @!attribute target_list_id
-      #   Required for list_follower_explorer, list_member_extractor &
+      #   List ID used to price list_follower_explorer, list_member_extractor, or
       #   list_post_extractor.
       #
       #   @return [String, nil]
       optional :target_list_id, String, api_name: :targetListId
 
       # @!attribute target_space_id
-      #   Required for space_explorer.
+      #   Space ID used to price space_explorer.
       #
       #   @return [String, nil]
       optional :target_space_id, String, api_name: :targetSpaceId
@@ -309,15 +309,15 @@ module XTwitterScraper
       #
       #   @param retweets_of_tweet_id [String] Estimate only retweets of this tweet ID (tweet_search_extractor)
       #
-      #   @param search_query [String] Required for tweet_search_extractor & community_search.
+      #   @param search_query [String] Query used to price tweet_search_extractor or community_search.
       #
       #   @param since_date [Date] Estimate start date in YYYY-MM-DD format (tweet_search_extractor)
       #
-      #   @param target_community_id [String] Required for community_post_extractor & community_search.
+      #   @param target_community_id [String] Community ID used to price community_post_extractor or community_search.
       #
-      #   @param target_list_id [String] Required for list_follower_explorer, list_member_extractor & list_post_extractor
+      #   @param target_list_id [String] List ID used to price list_follower_explorer, list_member_extractor, or list_pos
       #
-      #   @param target_space_id [String] Required for space_explorer.
+      #   @param target_space_id [String] Space ID used to price space_explorer.
       #
       #   @param target_tweet_id [String]
       #

data/lib/x_twitter_scraper/models/guest_wallet_create_params.rb

@@ -8,7 +8,7 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute amount_minor
-      #   Confirmed USD amount in cents.
+      #   USD cents accepted for this checkout.
       #
       #   @return [Integer]
       required :amount_minor, Integer
@@ -24,7 +24,7 @@ module XTwitterScraper
       required :idempotency_key, String
 
       # @!method initialize(amount_minor:, idempotency_key:, currency: :usd, request_options: {})
-      #   @param amount_minor [Integer] Confirmed USD amount in cents.
+      #   @param amount_minor [Integer] USD cents accepted for this checkout.
       #
       #   @param idempotency_key [String]
       #

data/lib/x_twitter_scraper/models/guest_wallet_create_response.rb

@@ -128,17 +128,37 @@ module XTwitterScraper
       class Authorization < XTwitterScraper::Internal::Type::BaseModel
         # @!attribute header
         #
-        #   @return [Symbol, :Authorization]
-        required :header, const: :Authorization
+        #   @return [Symbol, XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Header]
+        required :header, enum: -> { XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Header }
 
         # @!attribute scheme
         #
-        #   @return [Symbol, :Bearer]
-        required :scheme, const: :Bearer
+        #   @return [Symbol, XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Scheme]
+        required :scheme, enum: -> { XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Scheme }
 
-        # @!method initialize(header: :Authorization, scheme: :Bearer)
-        #   @param header [Symbol, :Authorization]
-        #   @param scheme [Symbol, :Bearer]
+        # @!method initialize(header:, scheme:)
+        #   @param header [Symbol, XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Header]
+        #   @param scheme [Symbol, XTwitterScraper::Models::GuestWalletCreateResponse::Authorization::Scheme]
+
+        # @see XTwitterScraper::Models::GuestWalletCreateResponse::Authorization#header
+        module Header
+          extend XTwitterScraper::Internal::Type::Enum
+
+          AUTHORIZATION = :Authorization
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see XTwitterScraper::Models::GuestWalletCreateResponse::Authorization#scheme
+        module Scheme
+          extend XTwitterScraper::Internal::Type::Enum
+
+          BEARER = :Bearer
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       # @see XTwitterScraper::Models::GuestWalletCreateResponse#status

data/lib/x_twitter_scraper/models/guest_wallet_topup_params.rb

@@ -8,7 +8,7 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute amount_minor
-      #   Confirmed USD amount in cents.
+      #   USD cents accepted for this checkout.
       #
       #   @return [Integer]
       required :amount_minor, Integer
@@ -24,7 +24,7 @@ module XTwitterScraper
       required :idempotency_key, String
 
       # @!method initialize(amount_minor:, idempotency_key:, currency: :usd, request_options: {})
-      #   @param amount_minor [Integer] Confirmed USD amount in cents.
+      #   @param amount_minor [Integer] USD cents accepted for this checkout.
       #
       #   @param idempotency_key [String]
       #