Add base twitch api module

Gemfile

@@ -57,3 +57,9 @@ gem "rest-client", "~> 2.1"
 gem 'awesome_print', :require => 'ap'
 
 gem "httparty", "~> 0.21.0"
+
+gem "faraday", "~> 2.9"
+
+gem "faraday-parse_dates", "~> 0.1.1"
+
+gem "faraday-retry", "~> 2.2"

Gemfile.lock

@@ -94,6 +94,14 @@ GEM
     erubi (1.12.0)
     et-orbi (1.2.7)
       tzinfo
+    faraday (2.9.0)
+      faraday-net_http (>= 2.0, < 3.2)
+    faraday-net_http (3.1.0)
+      net-http
+    faraday-parse_dates (0.1.1)
+      faraday (~> 2.0)
+    faraday-retry (2.2.0)
+      faraday (~> 2.0)
     figaro (1.2.0)
       thor (>= 0.14.0, < 2)
     fugit (1.9.0)
@@ -130,6 +138,8 @@ GEM
     msgpack (1.7.2)
     multi_xml (0.6.0)
     mutex_m (0.2.0)
+    net-http (0.4.1)
+      uri
     net-imap (0.4.10)
       date
       net-protocol
@@ -233,6 +243,7 @@ GEM
     timeout (0.4.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
+    uri (0.13.0)
     webrick (1.8.1)
     websocket-driver (0.7.6)
       websocket-extensions (>= 0.1.0)
@@ -251,6 +262,9 @@ DEPENDENCIES
   awesome_print
   bootsnap
   debug
+  faraday (~> 2.9)
+  faraday-parse_dates (~> 0.1.1)
+  faraday-retry (~> 2.2)
   figaro
   httparty (~> 0.21.0)
   pg (~> 1.1)

app/services/twitch-api.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'twitch/version'
+require_relative 'twitch/client'

app/services/twitch/api_error.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Twitch
+  # An error returned by the API.
+  class APIError < StandardError
+    # HTTP status code of the response.
+    attr_reader :status_code
+    # Body content of the response.
+    attr_reader :body
+
+    def initialize(status_code, body)
+      @status_code = status_code
+      @body = body
+
+      super(self.body['message'])
+    end
+  end
+end

app/services/twitch/automod_message_status.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Twitch
+  # A determination if AutoMod would allow a message in a particular channel's chat.
+  class AutomodMessageStatus
+    # ID of the message. Matches the field of the same name passed in the request.
+    attr_reader :msg_id
+    # Whether the message would meet AutoMod requirements for the channel.
+    attr_reader :is_permitted
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/bits_leader.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Twitch
+  # A user that is a leader for bits.
+  class BitsLeader
+    # ID of the user giving bits.
+    attr_reader :user_id
+    # Display name of the user giving bits.
+    attr_reader :user_name
+    # Ranking of the user giving bits.
+    # Reflects the parent object's date range.
+    attr_reader :rank
+    # Number of bits given in the parent object's date range.
+    attr_reader :score
+
+    def initialize(attributes = {})
+      @user_id = attributes['user_id']
+      @user_name = attributes['user_name']
+      @rank = attributes['rank']
+      @score = attributes['score']
+    end
+  end
+end

app/services/twitch/category.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Twitch
+  ## Data class for categories
+  class Category
+    ## A URL to an image of the game’s box art or streaming category.
+    attr_reader :box_art_url
+
+    ## The name of the game or category.
+    attr_reader :name
+
+    ## 	An ID that uniquely identifies the game or category.
+    attr_reader :id
+
+    ## Not always available:
+
+    ## The ID that IGDB uses to identify this game.
+    ## If the IGDB ID is not available to Twitch, this field is set to an empty string.
+    attr_reader :igdb_id
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/channel.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Twitch
+  # Data object for Twitch channels
+  # https://dev.twitch.tv/docs/api/reference#get-channel-information
+  class Channel
+    # Twitch User ID of this channel owner.
+    attr_reader :broadcaster_id
+    # Broadcaster's user login name.
+    attr_reader :broadcaster_login
+    # Twitch user display name of this channel owner.
+    attr_reader :broadcaster_name
+    # Language of the channel.
+    # A language value is either the ISO 639-1 two-letter code for a supported stream language
+    # or "other".
+    attr_reader :broadcaster_language
+    # Current game ID being played on the channel .
+    attr_reader :game_id
+    # Name of the game being played on the channel.
+    attr_reader :game_name
+    # Title of the stream.
+    attr_reader :title
+    # Stream delay in seconds.
+    attr_reader :delay
+
+    # Some endpoints, like "Search Channels", can return different fields
+    attr_reader :id
+    attr_reader :display_name
+    # A Boolean value that determines whether the broadcaster is streaming live.
+    # Is true if the broadcaster is streaming live; otherwise, false.
+    attr_reader :is_live
+    # The tags applied to the channel.
+    attr_reader :tags
+    # A URL to a thumbnail of the broadcaster’s profile image.
+    attr_reader :thumbnail_url
+    # The UTC date and time (in RFC3339 format) of when the broadcaster started streaming.
+    # The string is empty if the broadcaster is not streaming live.
+    attr_reader :started_at
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/cheermote.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative 'cheermote_tier'
+
+module Twitch
+  ## Data class for Cheermotes, animated emotes that viewers can assign Bits to.
+  class Cheermote
+    ## The name portion of the Cheermote string that you use in chat to cheer Bits.
+    ## The full Cheermote string is the concatenation of {prefix} + {number of Bits}.
+    ## For example, if the prefix is “Cheer” and you want to cheer 100 Bits,
+    ## the full Cheermote string is Cheer100.
+    ## When the Cheermote string is entered in chat,
+    ## Twitch converts it to the image associated with the Bits tier that was cheered.
+    attr_reader :prefix
+
+    ## A list of tier levels that the Cheermote supports.
+    ## Each tier identifies the range of Bits that you can cheer at that tier level
+    ## and an image that graphically identifies the tier level.
+    attr_reader :tiers
+
+    ## The type of Cheermote. Possible values are:
+    ## * global_first_party — A Twitch-defined Cheermote that is shown in the Bits card.
+    ## * global_third_party — A Twitch-defined Cheermote that is not shown in the Bits card.
+    ## * channel_custom — A broadcaster-defined Cheermote.
+    ## * display_only — Do not use; for internal use only.
+    ## * sponsored — A sponsor-defined Cheermote.
+    ##   When used, the sponsor adds additional Bits to the amount that the user cheered.
+    ##   For example, if the user cheered Terminator100, the broadcaster might receive 110 Bits,
+    ##   which includes the sponsor's 10 Bits contribution.
+    attr_reader :type
+
+    ## The order that the Cheermotes are shown in the Bits card.
+    ## The numbers may not be consecutive. For example, the numbers may jump from 1 to 7 to 13.
+    ## The order numbers are unique within a Cheermote type (for example, global_first_party)
+    ## but may not be unique amongst all Cheermotes in the response.
+    attr_reader :order
+
+    ## The date and time when this Cheermote was last updated.
+    attr_reader :last_updated
+
+    ## A Boolean value that indicates whether this Cheermote provides
+    ## a charitable contribution match during charity campaigns.
+    attr_reader :is_charitable
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        value = value.map { |tier| CheermoteTier.new(tier) } if key == 'tiers'
+
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/cheermote_tier.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative 'cheermote_tier_images'
+
+module Twitch
+  ## Data class for Cheermote Tier.
+  ## Each tier identifies the range of Bits that you can cheer at that tier level
+  ## and an image that graphically identifies the tier level.
+  class CheermoteTier
+    ## The minimum number of Bits that you must cheer at this tier level.
+    ## The maximum number of Bits that you can cheer at this level
+    ## is determined by the required minimum Bits of the next tier level minus 1.
+    ## For example, if `min_bits` is 1 and `min_bits` for the next tier is 100,
+    ## the Bits range for this tier level is 1 through 99.
+    ## The minimum Bits value of the last tier is the maximum number of Bits you can cheer
+    ## using this Cheermote. For example, 10000.
+    attr_reader :min_bits
+
+    ## 	The tier level. Possible tiers are:
+    ## * 1
+    ## * 100
+    ## * 500
+    ## * 1000
+    ## * 5000
+    ## * 10000
+    ## * 100000
+    attr_reader :id
+
+    ## The hex code of the color associated with this tier level (for example, `#979797`).
+    attr_reader :color
+
+    ## The animated and static image sets for the Cheermote.
+    ## The dictionary of images is organized by theme, format, and size.
+    ## The theme keys are `dark` and `light`.
+    ## Each theme is a dictionary of formats: `animated` and `static`.
+    ## Each format is a dictionary of sizes: `1`, `1.5`, `2`, `3`, and `4`.
+    ## The value of each size contains the URL to the image.
+    attr_reader :images
+
+    ## A Boolean value that determines whether users can cheer at this tier level.
+    attr_reader :can_cheer
+
+    ## A Boolean value that determines whether this tier level is shown in the Bits card.
+    ## Is `true` if this tier level is shown in the Bits card.
+    attr_reader :show_in_bits_card
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        value = CheermoteTierImages.new(value) if key == 'images'
+
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/cheermote_tier_image.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Twitch
+  ## Data class for Cheermote Tier image, static and animated
+  class CheermoteTierImage
+    ## Each theme is a dictionary of formats: `animated` and `static`.
+    ## Each format is a dictionary of sizes: `1`, `1.5`, `2`, `3`, and `4`.
+    ## The value of each size contains the URL to the image.
+    attr_reader :animated
+    attr_reader :static
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set :"@#{key}", value
+      end
+    end
+  end
+end

app/services/twitch/cheermote_tier_images.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'cheermote_tier_image'
+
+module Twitch
+  ## Data class for Cheermote Tier images by themes
+  class CheermoteTierImages
+    ## The theme keys are `dark` and `light`.
+    ## Each theme is a dictionary of formats: `animated` and `static`.
+    ## Each format is a dictionary of sizes: `1`, `1.5`, `2`, `3`, and `4`.
+    ## The value of each size contains the URL to the image.
+    attr_reader :dark
+    attr_reader :light
+
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        instance_variable_set :"@#{key}", CheermoteTierImage.new(value)
+      end
+    end
+  end
+end