x-twitter-scraper 0.4.5 → 0.5.2

data/lib/x_twitter_scraper/models/guest_wallet_topup_response.rb

@@ -144,17 +144,37 @@ module XTwitterScraper
       class Authorization < XTwitterScraper::Internal::Type::BaseModel
         # @!attribute header
         #
-        #   @return [Symbol, :Authorization]
-        required :header, const: :Authorization
+        #   @return [Symbol, XTwitterScraper::Models::GuestWalletTopupResponse::Authorization::Header]
+        required :header, enum: -> { XTwitterScraper::Models::GuestWalletTopupResponse::Authorization::Header }
 
         # @!attribute scheme
         #
-        #   @return [Symbol, :Bearer]
-        required :scheme, const: :Bearer
+        #   @return [Symbol, XTwitterScraper::Models::GuestWalletTopupResponse::Authorization::Scheme]
+        required :scheme, enum: -> { XTwitterScraper::Models::GuestWalletTopupResponse::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::GuestWalletTopupResponse::Authorization::Header]
+        #   @param scheme [Symbol, XTwitterScraper::Models::GuestWalletTopupResponse::Authorization::Scheme]
+
+        # @see XTwitterScraper::Models::GuestWalletTopupResponse::Authorization#header
+        module Header
+          extend XTwitterScraper::Internal::Type::Enum
+
+          AUTHORIZATION = :Authorization
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see XTwitterScraper::Models::GuestWalletTopupResponse::Authorization#scheme
+        module Scheme
+          extend XTwitterScraper::Internal::Type::Enum
+
+          BEARER = :Bearer
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       # @see XTwitterScraper::Models::GuestWalletTopupResponse#credential_notice

data/lib/x_twitter_scraper/models/search_tweet.rb

@@ -68,7 +68,7 @@ module XTwitterScraper
       optional :created_at, String, api_name: :createdAt
 
       # @!attribute display_text_range
-      #   Start and end offsets for rendered tweet text
+      #   Rendered text's start and end offsets.
       #
       #   @return [Array<Integer>, nil]
       optional :display_text_range,
@@ -83,19 +83,19 @@ module XTwitterScraper
       optional :entities, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
 
       # @!attribute in_reply_to_id
-      #   Tweet ID being replied to
+      #   ID of the tweet this result replies to.
       #
       #   @return [String, nil]
       optional :in_reply_to_id, String, api_name: :inReplyToId
 
       # @!attribute in_reply_to_user_id
-      #   User ID being replied to
+      #   ID of the user this result replies to.
       #
       #   @return [String, nil]
       optional :in_reply_to_user_id, String, api_name: :inReplyToUserId
 
       # @!attribute in_reply_to_username
-      #   Username being replied to
+      #   Username this result replies to.
       #
       #   @return [String, nil]
       optional :in_reply_to_username, String, api_name: :inReplyToUsername
@@ -125,7 +125,7 @@ module XTwitterScraper
       optional :is_reply, XTwitterScraper::Internal::Type::Boolean, api_name: :isReply
 
       # @!attribute lang
-      #   Tweet language code
+      #   Search result language code.
       #
       #   @return [String, nil]
       optional :lang, String
@@ -164,7 +164,7 @@ module XTwitterScraper
       optional :type, String
 
       # @!attribute url
-      #   Tweet permalink URL
+      #   Search result permalink.
       #
       #   @return [String, nil]
       optional :url, String
@@ -200,15 +200,15 @@ module XTwitterScraper
       #
       #   @param created_at [String]
       #
-      #   @param display_text_range [Array<Integer>] Start and end offsets for rendered tweet text
+      #   @param display_text_range [Array<Integer>] Rendered text's start and end offsets.
       #
       #   @param entities [Hash{Symbol=>Object}] Parsed search-result entities including URLs, mentions, hashtags, and media mark
       #
-      #   @param in_reply_to_id [String] Tweet ID being replied to
+      #   @param in_reply_to_id [String] ID of the tweet this result replies to.
       #
-      #   @param in_reply_to_user_id [String] User ID being replied to
+      #   @param in_reply_to_user_id [String] ID of the user this result replies to.
       #
-      #   @param in_reply_to_username [String] Username being replied to
+      #   @param in_reply_to_username [String] Username this result replies to.
       #
       #   @param is_limited_reply [Boolean] Whether the tweet has limited reply permissions
       #
@@ -218,7 +218,7 @@ module XTwitterScraper
       #
       #   @param is_reply [Boolean] True when this search result is a reply
       #
-      #   @param lang [String] Tweet language code
+      #   @param lang [String] Search result language code.
       #
       #   @param media [Array<XTwitterScraper::Models::TweetMedia>] Search-result media attachments, omitted when no media is present
       #
@@ -230,7 +230,7 @@ module XTwitterScraper
       #
       #   @param type [String]
       #
-      #   @param url [String] Tweet permalink URL
+      #   @param url [String] Search result permalink.
     end
   end
 end

data/lib/x_twitter_scraper/models/support/ticket_create_params.rb

@@ -18,9 +18,15 @@ module XTwitterScraper
         #   @return [String]
         required :subject, String
 
-        # @!method initialize(body:, subject:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(body:, subject:, idempotency_key: nil, request_options: {})
         #   @param body [String]
         #   @param subject [String]
+        #   @param idempotency_key [String]
         #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/x_twitter_scraper/models/support/ticket_create_response.rb

@@ -5,13 +5,50 @@ module XTwitterScraper
     module Support
       # @see XTwitterScraper::Resources::Support::Tickets#create
       class TicketCreateResponse < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute attachments
+        #
+        #   @return [Array<XTwitterScraper::Models::Support::TicketCreateResponse::Attachment>]
+        required :attachments,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::Support::TicketCreateResponse::Attachment] }
+
         # @!attribute public_id
         #
-        #   @return [String, nil]
-        optional :public_id, String, api_name: :publicId
+        #   @return [String]
+        required :public_id, String, api_name: :publicId
 
-        # @!method initialize(public_id: nil)
+        # @!method initialize(attachments:, public_id:)
+        #   @param attachments [Array<XTwitterScraper::Models::Support::TicketCreateResponse::Attachment>]
         #   @param public_id [String]
+
+        class Attachment < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute public_id
+          #
+          #   @return [String]
+          required :public_id, String, api_name: :publicId
+
+          # @!attribute status
+          #
+          #   @return [Symbol, XTwitterScraper::Models::Support::TicketCreateResponse::Attachment::Status]
+          required :status, enum: -> { XTwitterScraper::Models::Support::TicketCreateResponse::Attachment::Status }
+
+          # @!method initialize(public_id:, status:)
+          #   Attachment identifier and initial processing state.
+          #
+          #   @param public_id [String]
+          #   @param status [Symbol, XTwitterScraper::Models::Support::TicketCreateResponse::Attachment::Status]
+
+          # @see XTwitterScraper::Models::Support::TicketCreateResponse::Attachment#status
+          module Status
+            extend XTwitterScraper::Internal::Type::Enum
+
+            PENDING = :pending
+            READY = :ready
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

data/lib/x_twitter_scraper/models/support/ticket_reply_params.rb

@@ -18,9 +18,15 @@ module XTwitterScraper
         #   @return [String]
         required :body, String
 
-        # @!method initialize(id:, body:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(id:, body:, idempotency_key: nil, request_options: {})
         #   @param id [String]
         #   @param body [String]
+        #   @param idempotency_key [String]
         #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/x_twitter_scraper/models/support/ticket_reply_response.rb

@@ -5,13 +5,50 @@ module XTwitterScraper
     module Support
       # @see XTwitterScraper::Resources::Support::Tickets#reply
       class TicketReplyResponse < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute attachments
+        #
+        #   @return [Array<XTwitterScraper::Models::Support::TicketReplyResponse::Attachment>]
+        required :attachments,
+                 -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::Support::TicketReplyResponse::Attachment] }
+
         # @!attribute public_id
         #
-        #   @return [String, nil]
-        optional :public_id, String, api_name: :publicId
+        #   @return [String]
+        required :public_id, String, api_name: :publicId
 
-        # @!method initialize(public_id: nil)
+        # @!method initialize(attachments:, public_id:)
+        #   @param attachments [Array<XTwitterScraper::Models::Support::TicketReplyResponse::Attachment>]
         #   @param public_id [String]
+
+        class Attachment < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute public_id
+          #
+          #   @return [String]
+          required :public_id, String, api_name: :publicId
+
+          # @!attribute status
+          #
+          #   @return [Symbol, XTwitterScraper::Models::Support::TicketReplyResponse::Attachment::Status]
+          required :status, enum: -> { XTwitterScraper::Models::Support::TicketReplyResponse::Attachment::Status }
+
+          # @!method initialize(public_id:, status:)
+          #   Attachment identifier and initial processing state.
+          #
+          #   @param public_id [String]
+          #   @param status [Symbol, XTwitterScraper::Models::Support::TicketReplyResponse::Attachment::Status]
+
+          # @see XTwitterScraper::Models::Support::TicketReplyResponse::Attachment#status
+          module Status
+            extend XTwitterScraper::Internal::Type::Enum
+
+            PENDING = :pending
+            READY = :ready
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

data/lib/x_twitter_scraper/models/support/ticket_retrieve_response.rb

@@ -45,6 +45,12 @@ module XTwitterScraper
         #   @param updated_at [Time]
 
         class Message < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute attachments
+          #
+          #   @return [Array<XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment>, nil]
+          optional :attachments,
+                   -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment] }
+
           # @!attribute body
           #
           #   @return [String, nil]
@@ -60,10 +66,117 @@ module XTwitterScraper
           #   @return [String, nil]
           optional :sender, String
 
-          # @!method initialize(body: nil, created_at: nil, sender: nil)
+          # @!method initialize(attachments: nil, body: nil, created_at: nil, sender: nil)
+          #   @param attachments [Array<XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment>]
           #   @param body [String]
           #   @param created_at [Time]
           #   @param sender [String]
+
+          class Attachment < XTwitterScraper::Internal::Type::BaseModel
+            # @!attribute content_type
+            #   Validated media type.
+            #
+            #   @return [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::ContentType]
+            required :content_type,
+                     enum: -> { XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::ContentType },
+                     api_name: :contentType
+
+            # @!attribute filename
+            #
+            #   @return [String]
+            required :filename, String
+
+            # @!attribute kind
+            #   Attachment media class.
+            #
+            #   @return [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Kind]
+            required :kind,
+                     enum: -> { XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Kind }
+
+            # @!attribute public_id
+            #
+            #   @return [String]
+            required :public_id, String, api_name: :publicId
+
+            # @!attribute size_bytes
+            #
+            #   @return [Integer]
+            required :size_bytes, Integer, api_name: :sizeBytes
+
+            # @!attribute status
+            #   Storage processing state.
+            #
+            #   @return [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Status]
+            required :status,
+                     enum: -> { XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Status }
+
+            # @!attribute url
+            #
+            #   @return [String]
+            required :url, String
+
+            # @!method initialize(content_type:, filename:, kind:, public_id:, size_bytes:, status:, url:)
+            #   Downloadable image or video attached to a support message.
+            #
+            #   @param content_type [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::ContentType] Validated media type.
+            #
+            #   @param filename [String]
+            #
+            #   @param kind [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Kind] Attachment media class.
+            #
+            #   @param public_id [String]
+            #
+            #   @param size_bytes [Integer]
+            #
+            #   @param status [Symbol, XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment::Status] Storage processing state.
+            #
+            #   @param url [String]
+
+            # Validated media type.
+            #
+            # @see XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment#content_type
+            module ContentType
+              extend XTwitterScraper::Internal::Type::Enum
+
+              IMAGE_JPEG = :"image/jpeg"
+              IMAGE_PNG = :"image/png"
+              IMAGE_GIF = :"image/gif"
+              IMAGE_WEBP = :"image/webp"
+              VIDEO_MP4 = :"video/mp4"
+              VIDEO_QUICKTIME = :"video/quicktime"
+              VIDEO_WEBM = :"video/webm"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Attachment media class.
+            #
+            # @see XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment#kind
+            module Kind
+              extend XTwitterScraper::Internal::Type::Enum
+
+              IMAGE = :image
+              VIDEO = :video
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Storage processing state.
+            #
+            # @see XTwitterScraper::Models::Support::TicketRetrieveResponse::Message::Attachment#status
+            module Status
+              extend XTwitterScraper::Internal::Type::Enum
+
+              PENDING = :pending
+              READY = :ready
+              FAILED = :failed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
       end
     end

data/lib/x_twitter_scraper/models/x/communities/join_create_params.rb

@@ -20,11 +20,18 @@ module XTwitterScraper
           #   @return [String]
           required :account, String
 
-          # @!method initialize(id:, account:, request_options: {})
+          # @!attribute idempotency_key
+          #
+          #   @return [String]
+          required :idempotency_key, String
+
+          # @!method initialize(id:, account:, idempotency_key:, request_options: {})
           #   @param id [String]
           #
           #   @param account [String] X account identifier (@username or account ID)
           #
+          #   @param idempotency_key [String]
+          #
           #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
         end
       end