x-twitter-scraper 0.3.0 → 0.4.0

data/lib/x_twitter_scraper/models/event_detail.rb

@@ -2,6 +2,7 @@
 
 module XTwitterScraper
   module Models
+    # @see XTwitterScraper::Resources::Events#retrieve
     class EventDetail < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute id
       #
@@ -25,9 +26,10 @@ module XTwitterScraper
       required :occurred_at, Time, api_name: :occurredAt
 
       # @!attribute type
+      #   Type of monitor event fired when account activity occurs.
       #
-      #   @return [Symbol, XTwitterScraper::Models::EventDetail::Type]
-      required :type, enum: -> { XTwitterScraper::EventDetail::Type }
+      #   @return [Symbol, XTwitterScraper::Models::EventType]
+      required :type, enum: -> { XTwitterScraper::EventType }
 
       # @!attribute username
       #
@@ -40,6 +42,8 @@ module XTwitterScraper
       optional :x_event_id, String, api_name: :xEventId
 
       # @!method initialize(id:, data:, monitor_id:, occurred_at:, type:, username:, x_event_id: nil)
+      #   Full monitor event including payload data and optional X event ID.
+      #
       #   @param id [String]
       #
       #   @param data [Hash{Symbol=>Object}] Event payload — shape varies by event type (JSON)
@@ -48,26 +52,11 @@ module XTwitterScraper
       #
       #   @param occurred_at [Time]
       #
-      #   @param type [Symbol, XTwitterScraper::Models::EventDetail::Type]
+      #   @param type [Symbol, XTwitterScraper::Models::EventType] Type of monitor event fired when account activity occurs.
       #
       #   @param username [String]
       #
       #   @param x_event_id [String]
-
-      # @see XTwitterScraper::Models::EventDetail#type
-      module Type
-        extend XTwitterScraper::Internal::Type::Enum
-
-        TWEET_NEW = :"tweet.new"
-        TWEET_REPLY = :"tweet.reply"
-        TWEET_RETWEET = :"tweet.retweet"
-        TWEET_QUOTE = :"tweet.quote"
-        FOLLOWER_GAINED = :"follower.gained"
-        FOLLOWER_LOST = :"follower.lost"
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/x_twitter_scraper/models/event_list_params.rb

@@ -8,50 +8,39 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute after
-      #   Cursor for pagination
+      #   Cursor for keyset pagination
       #
       #   @return [String, nil]
       optional :after, String
 
       # @!attribute event_type
+      #   Filter events by type
       #
-      #   @return [Symbol, XTwitterScraper::Models::EventListParams::EventType, nil]
-      optional :event_type, enum: -> { XTwitterScraper::EventListParams::EventType }
+      #   @return [Symbol, XTwitterScraper::Models::EventType, nil]
+      optional :event_type, enum: -> { XTwitterScraper::EventType }
 
       # @!attribute limit
+      #   Maximum number of items to return (1-100, default 50)
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute monitor_id
+      #   Filter events by monitor ID
       #
       #   @return [String, nil]
       optional :monitor_id, String
 
       # @!method initialize(after: nil, event_type: nil, limit: nil, monitor_id: nil, request_options: {})
-      #   @param after [String] Cursor for pagination
+      #   @param after [String] Cursor for keyset pagination
       #
-      #   @param event_type [Symbol, XTwitterScraper::Models::EventListParams::EventType]
+      #   @param event_type [Symbol, XTwitterScraper::Models::EventType] Filter events by type
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return (1-100, default 50)
       #
-      #   @param monitor_id [String]
+      #   @param monitor_id [String] Filter events by monitor ID
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
-
-      module EventType
-        extend XTwitterScraper::Internal::Type::Enum
-
-        TWEET_NEW = :"tweet.new"
-        TWEET_REPLY = :"tweet.reply"
-        TWEET_RETWEET = :"tweet.retweet"
-        TWEET_QUOTE = :"tweet.quote"
-        FOLLOWER_GAINED = :"follower.gained"
-        FOLLOWER_LOST = :"follower.lost"
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/x_twitter_scraper/models/event_list_response.rb

@@ -6,9 +6,8 @@ module XTwitterScraper
     class EventListResponse < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute events
       #
-      #   @return [Array<XTwitterScraper::Models::EventListResponse::Event>]
-      required :events,
-               -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::EventListResponse::Event] }
+      #   @return [Array<XTwitterScraper::Models::Event>]
+      required :events, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Event] }
 
       # @!attribute has_more
       #
@@ -21,64 +20,9 @@ module XTwitterScraper
       optional :next_cursor, String, api_name: :nextCursor
 
       # @!method initialize(events:, has_more:, next_cursor: nil)
-      #   @param events [Array<XTwitterScraper::Models::EventListResponse::Event>]
+      #   @param events [Array<XTwitterScraper::Models::Event>]
       #   @param has_more [Boolean]
       #   @param next_cursor [String]
-
-      class Event < XTwitterScraper::Internal::Type::BaseModel
-        # @!attribute id
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!attribute data
-        #
-        #   @return [Hash{Symbol=>Object}]
-        required :data, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
-
-        # @!attribute monitor_id
-        #
-        #   @return [String]
-        required :monitor_id, String, api_name: :monitorId
-
-        # @!attribute occurred_at
-        #
-        #   @return [Time]
-        required :occurred_at, Time, api_name: :occurredAt
-
-        # @!attribute type
-        #
-        #   @return [Symbol, XTwitterScraper::Models::EventListResponse::Event::Type]
-        required :type, enum: -> { XTwitterScraper::Models::EventListResponse::Event::Type }
-
-        # @!attribute username
-        #
-        #   @return [String]
-        required :username, String
-
-        # @!method initialize(id:, data:, monitor_id:, occurred_at:, type:, username:)
-        #   @param id [String]
-        #   @param data [Hash{Symbol=>Object}]
-        #   @param monitor_id [String]
-        #   @param occurred_at [Time]
-        #   @param type [Symbol, XTwitterScraper::Models::EventListResponse::Event::Type]
-        #   @param username [String]
-
-        # @see XTwitterScraper::Models::EventListResponse::Event#type
-        module Type
-          extend XTwitterScraper::Internal::Type::Enum
-
-          TWEET_NEW = :"tweet.new"
-          TWEET_REPLY = :"tweet.reply"
-          TWEET_RETWEET = :"tweet.retweet"
-          TWEET_QUOTE = :"tweet.quote"
-          FOLLOWER_GAINED = :"follower.gained"
-          FOLLOWER_LOST = :"follower.lost"
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
     end
   end
 end

data/lib/x_twitter_scraper/models/event_type.rb

@@ -2,6 +2,7 @@
 
 module XTwitterScraper
   module Models
+    # Type of monitor event fired when account activity occurs.
     module EventType
       extend XTwitterScraper::Internal::Type::Enum
 

data/lib/x_twitter_scraper/models/extraction_estimate_cost_params.rb

@@ -8,6 +8,7 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute tool_type
+      #   Identifier for the extraction tool used to run a job.
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::ToolType]
       required :tool_type,
@@ -15,19 +16,19 @@ module XTwitterScraper
                api_name: :toolType
 
       # @!attribute advanced_query
-      #   Raw advanced search query appended as-is (tweet_search_extractor)
+      #   Raw advanced query string appended to the estimate (tweet_search_extractor)
       #
       #   @return [String, nil]
       optional :advanced_query, String, api_name: :advancedQuery
 
       # @!attribute exact_phrase
-      #   Exact phrase to match (tweet_search_extractor)
+      #   Exact phrase filter for search estimation
       #
       #   @return [String, nil]
       optional :exact_phrase, String, api_name: :exactPhrase
 
       # @!attribute exclude_words
-      #   Words to exclude from results (tweet_search_extractor)
+      #   Words excluded from estimated search results
       #
       #   @return [String, nil]
       optional :exclude_words, String, api_name: :excludeWords
@@ -63,13 +64,13 @@ module XTwitterScraper
       optional :target_username, String, api_name: :targetUsername
 
       # @!method initialize(tool_type:, advanced_query: nil, exact_phrase: nil, exclude_words: nil, search_query: nil, target_community_id: nil, target_list_id: nil, target_space_id: nil, target_tweet_id: nil, target_username: nil, request_options: {})
-      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::ToolType]
+      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::ToolType] Identifier for the extraction tool used to run a job.
       #
-      #   @param advanced_query [String] Raw advanced search query appended as-is (tweet_search_extractor)
+      #   @param advanced_query [String] Raw advanced query string appended to the estimate (tweet_search_extractor)
       #
-      #   @param exact_phrase [String] Exact phrase to match (tweet_search_extractor)
+      #   @param exact_phrase [String] Exact phrase filter for search estimation
       #
-      #   @param exclude_words [String] Words to exclude from results (tweet_search_extractor)
+      #   @param exclude_words [String] Words excluded from estimated search results
       #
       #   @param search_query [String]
       #
@@ -85,6 +86,7 @@ module XTwitterScraper
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
 
+      # Identifier for the extraction tool used to run a job.
       module ToolType
         extend XTwitterScraper::Internal::Type::Enum
 

data/lib/x_twitter_scraper/models/extraction_export_results_params.rb

@@ -13,15 +13,19 @@ module XTwitterScraper
       required :id, String
 
       # @!attribute format_
+      #   Export file format
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format, nil]
       optional :format_, enum: -> { XTwitterScraper::ExtractionExportResultsParams::Format }
 
       # @!method initialize(id:, format_: nil, request_options: {})
       #   @param id [String]
-      #   @param format_ [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format]
+      #
+      #   @param format_ [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format] Export file format
+      #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
 
+      # Export file format
       module Format
         extend XTwitterScraper::Internal::Type::Enum
 

data/lib/x_twitter_scraper/models/extraction_job.rb

@@ -19,6 +19,7 @@ module XTwitterScraper
       required :status, enum: -> { XTwitterScraper::ExtractionJob::Status }
 
       # @!attribute tool_type
+      #   Identifier for the extraction tool used to run a job.
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionJob::ToolType]
       required :tool_type, enum: -> { XTwitterScraper::ExtractionJob::ToolType }, api_name: :toolType
@@ -34,11 +35,18 @@ module XTwitterScraper
       optional :completed_at, Time, api_name: :completedAt
 
       # @!method initialize(id:, created_at:, status:, tool_type:, total_results:, completed_at: nil)
+      #   Extraction job tracking status, tool type, and result count.
+      #
       #   @param id [String]
+      #
       #   @param created_at [Time]
+      #
       #   @param status [Symbol, XTwitterScraper::Models::ExtractionJob::Status]
-      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionJob::ToolType]
+      #
+      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionJob::ToolType] Identifier for the extraction tool used to run a job.
+      #
       #   @param total_results [Integer]
+      #
       #   @param completed_at [Time]
 
       # @see XTwitterScraper::Models::ExtractionJob#status
@@ -53,6 +61,8 @@ module XTwitterScraper
         #   @return [Array<Symbol>]
       end
 
+      # Identifier for the extraction tool used to run a job.
+      #
       # @see XTwitterScraper::Models::ExtractionJob#tool_type
       module ToolType
         extend XTwitterScraper::Internal::Type::Enum

data/lib/x_twitter_scraper/models/extraction_list_params.rb

@@ -8,37 +8,41 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute after
-      #   Cursor for pagination
+      #   Cursor for keyset pagination
       #
       #   @return [String, nil]
       optional :after, String
 
       # @!attribute limit
+      #   Maximum number of items to return (1-100, default 50)
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!attribute status
+      #   Filter by job status
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionListParams::Status, nil]
       optional :status, enum: -> { XTwitterScraper::ExtractionListParams::Status }
 
       # @!attribute tool_type
+      #   Filter by extraction tool type
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionListParams::ToolType, nil]
       optional :tool_type, enum: -> { XTwitterScraper::ExtractionListParams::ToolType }
 
       # @!method initialize(after: nil, limit: nil, status: nil, tool_type: nil, request_options: {})
-      #   @param after [String] Cursor for pagination
+      #   @param after [String] Cursor for keyset pagination
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of items to return (1-100, default 50)
       #
-      #   @param status [Symbol, XTwitterScraper::Models::ExtractionListParams::Status]
+      #   @param status [Symbol, XTwitterScraper::Models::ExtractionListParams::Status] Filter by job status
       #
-      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionListParams::ToolType]
+      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionListParams::ToolType] Filter by extraction tool type
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
 
+      # Filter by job status
       module Status
         extend XTwitterScraper::Internal::Type::Enum
 
@@ -50,6 +54,7 @@ module XTwitterScraper
         #   @return [Array<Symbol>]
       end
 
+      # Filter by extraction tool type
       module ToolType
         extend XTwitterScraper::Internal::Type::Enum
 

data/lib/x_twitter_scraper/models/extraction_list_response.rb

@@ -6,9 +6,8 @@ module XTwitterScraper
     class ExtractionListResponse < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute extractions
       #
-      #   @return [Array<XTwitterScraper::Models::ExtractionListResponse::Extraction>]
-      required :extractions,
-               -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::Models::ExtractionListResponse::Extraction] }
+      #   @return [Array<XTwitterScraper::Models::ExtractionJob>]
+      required :extractions, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::ExtractionJob] }
 
       # @!attribute has_more
       #
@@ -21,92 +20,9 @@ module XTwitterScraper
       optional :next_cursor, String, api_name: :nextCursor
 
       # @!method initialize(extractions:, has_more:, next_cursor: nil)
-      #   @param extractions [Array<XTwitterScraper::Models::ExtractionListResponse::Extraction>]
+      #   @param extractions [Array<XTwitterScraper::Models::ExtractionJob>]
       #   @param has_more [Boolean]
       #   @param next_cursor [String]
-
-      class Extraction < XTwitterScraper::Internal::Type::BaseModel
-        # @!attribute id
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!attribute created_at
-        #
-        #   @return [Time]
-        required :created_at, Time, api_name: :createdAt
-
-        # @!attribute status
-        #
-        #   @return [Symbol, XTwitterScraper::Models::ExtractionListResponse::Extraction::Status]
-        required :status, enum: -> { XTwitterScraper::Models::ExtractionListResponse::Extraction::Status }
-
-        # @!attribute tool_type
-        #
-        #   @return [Symbol, XTwitterScraper::Models::ExtractionListResponse::Extraction::ToolType]
-        required :tool_type,
-                 enum: -> { XTwitterScraper::Models::ExtractionListResponse::Extraction::ToolType },
-                 api_name: :toolType
-
-        # @!attribute total_results
-        #
-        #   @return [Integer]
-        required :total_results, Integer, api_name: :totalResults
-
-        # @!attribute completed_at
-        #
-        #   @return [Time, nil]
-        optional :completed_at, Time, api_name: :completedAt
-
-        # @!method initialize(id:, created_at:, status:, tool_type:, total_results:, completed_at: nil)
-        #   @param id [String]
-        #   @param created_at [Time]
-        #   @param status [Symbol, XTwitterScraper::Models::ExtractionListResponse::Extraction::Status]
-        #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionListResponse::Extraction::ToolType]
-        #   @param total_results [Integer]
-        #   @param completed_at [Time]
-
-        # @see XTwitterScraper::Models::ExtractionListResponse::Extraction#status
-        module Status
-          extend XTwitterScraper::Internal::Type::Enum
-
-          RUNNING = :running
-          COMPLETED = :completed
-          FAILED = :failed
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
-        # @see XTwitterScraper::Models::ExtractionListResponse::Extraction#tool_type
-        module ToolType
-          extend XTwitterScraper::Internal::Type::Enum
-
-          ARTICLE_EXTRACTOR = :article_extractor
-          COMMUNITY_EXTRACTOR = :community_extractor
-          COMMUNITY_MODERATOR_EXPLORER = :community_moderator_explorer
-          COMMUNITY_POST_EXTRACTOR = :community_post_extractor
-          COMMUNITY_SEARCH = :community_search
-          FOLLOWER_EXPLORER = :follower_explorer
-          FOLLOWING_EXPLORER = :following_explorer
-          LIST_FOLLOWER_EXPLORER = :list_follower_explorer
-          LIST_MEMBER_EXTRACTOR = :list_member_extractor
-          LIST_POST_EXTRACTOR = :list_post_extractor
-          MENTION_EXTRACTOR = :mention_extractor
-          PEOPLE_SEARCH = :people_search
-          POST_EXTRACTOR = :post_extractor
-          QUOTE_EXTRACTOR = :quote_extractor
-          REPLY_EXTRACTOR = :reply_extractor
-          REPOST_EXTRACTOR = :repost_extractor
-          SPACE_EXPLORER = :space_explorer
-          THREAD_EXTRACTOR = :thread_extractor
-          TWEET_SEARCH_EXTRACTOR = :tweet_search_extractor
-          VERIFIED_FOLLOWER_EXPLORER = :verified_follower_explorer
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
     end
   end
 end

data/lib/x_twitter_scraper/models/extraction_retrieve_params.rb

@@ -13,12 +13,13 @@ module XTwitterScraper
       required :id, String
 
       # @!attribute after
-      #   Cursor for pagination
+      #   Cursor for keyset pagination
       #
       #   @return [String, nil]
       optional :after, String
 
       # @!attribute limit
+      #   Maximum number of results to return (1-1000, default 100)
       #
       #   @return [Integer, nil]
       optional :limit, Integer
@@ -26,9 +27,9 @@ module XTwitterScraper
       # @!method initialize(id:, after: nil, limit: nil, request_options: {})
       #   @param id [String]
       #
-      #   @param after [String] Cursor for pagination
+      #   @param after [String] Cursor for keyset pagination
       #
-      #   @param limit [Integer]
+      #   @param limit [Integer] Maximum number of results to return (1-1000, default 100)
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/x_twitter_scraper/models/extraction_run_params.rb

@@ -8,6 +8,7 @@ module XTwitterScraper
       include XTwitterScraper::Internal::Type::RequestParameters
 
       # @!attribute tool_type
+      #   Identifier for the extraction tool used to run a job.
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionRunParams::ToolType]
       required :tool_type, enum: -> { XTwitterScraper::ExtractionRunParams::ToolType }, api_name: :toolType
@@ -61,7 +62,7 @@ module XTwitterScraper
       optional :target_username, String, api_name: :targetUsername
 
       # @!method initialize(tool_type:, advanced_query: nil, exact_phrase: nil, exclude_words: nil, search_query: nil, target_community_id: nil, target_list_id: nil, target_space_id: nil, target_tweet_id: nil, target_username: nil, request_options: {})
-      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionRunParams::ToolType]
+      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionRunParams::ToolType] Identifier for the extraction tool used to run a job.
       #
       #   @param advanced_query [String] Raw advanced search query appended as-is (tweet_search_extractor)
       #
@@ -83,6 +84,7 @@ module XTwitterScraper
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
 
+      # Identifier for the extraction tool used to run a job.
       module ToolType
         extend XTwitterScraper::Internal::Type::Enum
 

data/lib/x_twitter_scraper/models/extraction_run_response.rb

@@ -11,31 +11,26 @@ module XTwitterScraper
 
       # @!attribute status
       #
-      #   @return [Symbol, XTwitterScraper::Models::ExtractionRunResponse::Status]
-      required :status, enum: -> { XTwitterScraper::Models::ExtractionRunResponse::Status }
+      #   @return [Symbol, :running]
+      required :status, const: :running
 
       # @!attribute tool_type
+      #   Identifier for the extraction tool used to run a job.
       #
       #   @return [Symbol, XTwitterScraper::Models::ExtractionRunResponse::ToolType]
       required :tool_type,
                enum: -> { XTwitterScraper::Models::ExtractionRunResponse::ToolType },
                api_name: :toolType
 
-      # @!method initialize(id:, status:, tool_type:)
+      # @!method initialize(id:, tool_type:, status: :running)
       #   @param id [String]
-      #   @param status [Symbol, XTwitterScraper::Models::ExtractionRunResponse::Status]
-      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionRunResponse::ToolType]
-
-      # @see XTwitterScraper::Models::ExtractionRunResponse#status
-      module Status
-        extend XTwitterScraper::Internal::Type::Enum
-
-        RUNNING = :running
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #
+      #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionRunResponse::ToolType] Identifier for the extraction tool used to run a job.
+      #
+      #   @param status [Symbol, :running]
 
+      # Identifier for the extraction tool used to run a job.
+      #
       # @see XTwitterScraper::Models::ExtractionRunResponse#tool_type
       module ToolType
         extend XTwitterScraper::Internal::Type::Enum

data/lib/x_twitter_scraper/models/integration.rb

@@ -2,6 +2,7 @@
 
 module XTwitterScraper
   module Models
+    # @see XTwitterScraper::Resources::Integrations#create
     class Integration < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute id
       #
@@ -20,10 +21,11 @@ module XTwitterScraper
       required :created_at, Time, api_name: :createdAt
 
       # @!attribute event_types
+      #   Array of event types to subscribe to.
       #
-      #   @return [Array<Symbol, XTwitterScraper::Models::Integration::EventType>]
+      #   @return [Array<Symbol, XTwitterScraper::Models::EventType>]
       required :event_types,
-               -> { XTwitterScraper::Internal::Type::ArrayOf[enum: XTwitterScraper::Integration::EventType] },
+               -> { XTwitterScraper::Internal::Type::ArrayOf[enum: XTwitterScraper::EventType] },
                api_name: :eventTypes
 
       # @!attribute is_active
@@ -38,8 +40,8 @@ module XTwitterScraper
 
       # @!attribute type
       #
-      #   @return [Symbol, XTwitterScraper::Models::Integration::Type]
-      required :type, enum: -> { XTwitterScraper::Integration::Type }
+      #   @return [Symbol, :telegram]
+      required :type, const: :telegram
 
       # @!attribute filters
       #   Event filter rules (JSON)
@@ -62,21 +64,21 @@ module XTwitterScraper
       #   @return [Boolean, nil]
       optional :silent_push, XTwitterScraper::Internal::Type::Boolean, api_name: :silentPush
 
-      # @!method initialize(id:, config:, created_at:, event_types:, is_active:, name:, type:, filters: nil, message_template: nil, scope_all_monitors: nil, silent_push: nil)
+      # @!method initialize(id:, config:, created_at:, event_types:, is_active:, name:, filters: nil, message_template: nil, scope_all_monitors: nil, silent_push: nil, type: :telegram)
+      #   Third-party integration (e.g. Telegram) subscribed to monitor events.
+      #
       #   @param id [String]
       #
       #   @param config [Hash{Symbol=>Object}] Integration config — shape varies by type (JSON)
       #
       #   @param created_at [Time]
       #
-      #   @param event_types [Array<Symbol, XTwitterScraper::Models::Integration::EventType>]
+      #   @param event_types [Array<Symbol, XTwitterScraper::Models::EventType>] Array of event types to subscribe to.
       #
       #   @param is_active [Boolean]
       #
       #   @param name [String]
       #
-      #   @param type [Symbol, XTwitterScraper::Models::Integration::Type]
-      #
       #   @param filters [Hash{Symbol=>Object}] Event filter rules (JSON)
       #
       #   @param message_template [String]
@@ -84,30 +86,8 @@ module XTwitterScraper
       #   @param scope_all_monitors [Boolean]
       #
       #   @param silent_push [Boolean]
-
-      module EventType
-        extend XTwitterScraper::Internal::Type::Enum
-
-        TWEET_NEW = :"tweet.new"
-        TWEET_REPLY = :"tweet.reply"
-        TWEET_RETWEET = :"tweet.retweet"
-        TWEET_QUOTE = :"tweet.quote"
-        FOLLOWER_GAINED = :"follower.gained"
-        FOLLOWER_LOST = :"follower.lost"
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
-
-      # @see XTwitterScraper::Models::Integration#type
-      module Type
-        extend XTwitterScraper::Internal::Type::Enum
-
-        TELEGRAM = :telegram
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #
+      #   @param type [Symbol, :telegram]
     end
   end
 end