relic_link 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0a6925bd59c93badd256bc6e31c23cf2ecd58827b93b604f2ce4fd954924ee5
-  data.tar.gz: 68e0f9f49e38f2c5d7b6e870684828c21bc88e9d4ecd56c4a7d6245e94462d43
+  metadata.gz: 933d2d2f0ea7389569d273f910d7c81ccd0abb7f4db84353ba52a537a44fcff8
+  data.tar.gz: 927197b6cf76cc074e4a01bf945f9970005e1c10322ec260f3117022fa39c9ef
 SHA512:
-  metadata.gz: 9b6b44e95aab707016e1825eecd7f952f63bdceb299b5622fa6d61b27e8930b7559066eab6fd35f83aa4be2131713bab4c17097cb86f46abe878d7bba3228480
-  data.tar.gz: cf4eec64ecffecffb3e4d0e313c5fc0f6c66d5135103be65ddffa4c8251c9d960afbaa706c945290e5c6ce160eaeb18f39a2e4d5055db212906ce8811d1a1e08
+  metadata.gz: d1a53aefa0bd7708f790901dd03d25446b04702dabf7037abeacdef38127365ba9d5f9ffd37969a5604ca254ed73f08f2fa6908b7eda5cba6427e9e49c314d18
+  data.tar.gz: 5b1286b258c58bd9fcaf29123da22a944a6942a455b955bfe1b7e4e9b8f1951500c495b13e364d58ce3141cc8a8fe323482904b756f7b2f72726cf81d826d657

data/.rubocop.yml

@@ -8,6 +8,9 @@ Layout/AccessModifierIndentation:
 Metrics/BlockLength:
   Enabled: false
 
+Metrics/MethodLength:
+  Max: 15
+
 Style/GlobalStdStream:
   Enabled: false
 

data/.ruby-version

@@ -1 +1 @@
-3.2.1
+3.2.4

data/Gemfile

@@ -5,10 +5,10 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in relic_link.gemspec
 gemspec
 
-gem 'rake', '~> 13.1'
+gem 'rake', '~> 13.2'
 
 gem 'rspec', '~> 3.13'
 
-gem 'rubocop', '~> 1.61'
+gem 'rubocop', '~> 1.65'
 
 gem 'vcr', '~> 6.2'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    relic_link (1.1.0)
+    relic_link (1.2.0)
       faraday (~> 2.7)
       faraday-mashify (~> 0.1)
       hashie (~> 5.0)
@@ -11,68 +11,73 @@ GEM
   specs:
     ast (2.4.2)
     diff-lcs (1.5.1)
-    faraday (2.9.0)
+    faraday (2.10.1)
       faraday-net_http (>= 2.0, < 3.2)
+      logger
     faraday-mashify (0.1.1)
       faraday (~> 2.0)
       hashie
-    faraday-net_http (3.1.0)
+    faraday-net_http (3.1.1)
       net-http
     hashie (5.0.0)
-    json (2.7.1)
+    json (2.7.2)
     language_server-protocol (3.17.0.3)
+    logger (1.6.0)
     net-http (0.4.1)
       uri
-    parallel (1.24.0)
-    parser (3.3.0.5)
+    parallel (1.26.1)
+    parser (3.3.4.2)
       ast (~> 2.4.1)
       racc
-    racc (1.7.3)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.1.0)
-    regexp_parser (2.9.0)
-    rexml (3.2.6)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rexml (3.3.4)
+      strscan
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
     rspec-core (3.13.0)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.1)
-    rubocop (1.61.0)
+    rubocop (1.65.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
+      regexp_parser (>= 2.4, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.1)
-      parser (>= 3.3.0.4)
+    rubocop-ast (1.32.0)
+      parser (>= 3.3.1.0)
     ruby-progressbar (1.13.0)
+    strscan (3.1.0)
     unicode-display_width (2.5.0)
     uri (0.13.0)
     vcr (6.2.0)
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-23
   x86_64-linux
 
 DEPENDENCIES
-  rake (~> 13.1)
+  rake (~> 13.2)
   relic_link!
   rspec (~> 3.13)
-  rubocop (~> 1.61)
+  rubocop (~> 1.65)
   vcr (~> 6.2)
 
 BUNDLED WITH
-   2.4.7
+   2.5.17

data/README.md

@@ -1,6 +1,6 @@
 # RelicLink
 
-[![Gem Version](https://badge.fury.io/rb/relic_link.svg)](https://badge.fury.io/rb/relic_link) [![Documentation](https://img.shields.io/badge/View-Documentation-blue.svg)](https://rubydoc.info/github/ryantaylor/relic_link/v1.1.0)
+[![Gem Version](https://badge.fury.io/rb/relic_link.svg)](https://badge.fury.io/rb/relic_link) [![Documentation](https://img.shields.io/badge/View-Documentation-blue.svg)](https://rubydoc.info/github/ryantaylor/relic_link/v1.2.0)
 
 A client wrapper for Relic APIs. Currently supports the Company of Heroes 3 leaderboard, stats, and recent matches API.
 
@@ -29,7 +29,7 @@ client.recent_match_history(profile_ids: [8230])
 client.recent_match_history_by_profile_id(8230)
 client.personal_stats(profile_ids: [8230])
 ```
-Consult the [documentation](https://rubydoc.info/github/ryantaylor/relic_link/v1.1.0) for all endpoints that have been discovered and are currently queryable. Note that Relic does not publish official documentation for their endpoints, so the functionality here is based on best estimates and is subject to change without warning. Please open an issue if you are aware of endpoints that are not exposed in this library!
+Consult the [documentation](https://rubydoc.info/github/ryantaylor/relic_link/v1.2.0) for all endpoints that have been discovered and are currently queryable. Note that Relic does not publish official documentation for their endpoints, so the functionality here is based on best estimates and is subject to change without warning. Please open an issue if you are aware of endpoints that are not exposed in this library!
 
 ## Contributing
 

data/lib/relic_link/coh3/api/endpoints/leaderboards.rb

@@ -14,7 +14,7 @@ module RelicLink
           # @raise [RelicLink::Errors::ServerError] if Relic's API is down.
           # @raise [RelicLink::Errors::RateLimitError] if you're rate-limited.
           def available_leaderboards
-            get('getAvailableLeaderboards')
+            get(stats, 'getAvailableLeaderboards')
           end
 
           # Retrieve the leaderboard with the given ID. For your convenience
@@ -42,7 +42,7 @@ module RelicLink
           def leaderboard(options = {})
             raise ArgumentError, 'Required argument :leaderboard_id missing' if options[:leaderboard_id].nil?
 
-            get('getLeaderboard2', format_sort_key(options))
+            get(stats, 'getLeaderboard2', format_sort_key(options))
           end
 
         private

data/lib/relic_link/coh3/api/endpoints/matches.rb

@@ -33,7 +33,7 @@ module RelicLink
               raise ArgumentError, 'Missing one of required arguments :profile_ids, :aliases, or :profile_names'
             end
 
-            get('getRecentMatchHistory', array_params(options))
+            get(stats, 'getRecentMatchHistory', array_params(options))
           end
 
           # Retrieve the match history information for the given profile ID. Profile
@@ -51,7 +51,7 @@ module RelicLink
           def recent_match_history_by_profile_id(profile_id)
             raise ArgumentError, 'Required argument :profile_id missing' if profile_id.nil?
 
-            get('getRecentMatchHistoryByProfileId', { profile_id: })
+            get(stats, 'getRecentMatchHistoryByProfileId', { profile_id: })
           end
         end
       end

data/lib/relic_link/coh3/api/endpoints/replays.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module RelicLink
+  module Coh3
+    module Api
+      module Endpoints
+        # Endpoint definitions for the internal CoH3 replays API.
+        module Replays
+          # Request a signed download URL for a replay at the given +path+, using the given
+          # authentication +token+. Path values can be retrieved from any endpoint that returns
+          # a player's game history, by looking for a +matchurls+ key in the JSON response.
+          # Note that this is a protected internal endpoint, which means a request without a
+          # valid token will return an authentication error. Tokens can be extracted from the
+          # game client by setting up a man-in-the-middle proxy between your game client and
+          # the Relic servers, but be warned that tokens expire quickly and this endpoint may
+          # change at any time. Use at your own risk!
+          #
+          # Relic generally keeps a player's 10 most recent replay files, and files older than
+          # that are removed from storage and inaccessible. When this happens, the replay is
+          # considered expired and requests for that path will raise an error.
+          #
+          # @option options [String] :token
+          #   Valid CoH3 game client authentication token (required)
+          # @option options [String] :path
+          #   Path to a CoH3 replay file stored on Relic's infrastructure (required)
+          #
+          # @raise [ArgumentError] if one of the required parameters are not provided.
+          # @raise [RelicLink::Errors::ServerError] if Relic's API is down.
+          # @raise [RelicLink::Errors::UnauthorizedError] if the +token+ provided is invalid.
+          # @raise [Errors::ExpiredPath] if the file at the +path+ provided has expired or does not exist.
+          def replay_url(options = {})
+            validate_options!(options)
+            get(replays, 'requestSignedReplayDownloadUri', {
+                  connect_id: options[:token],
+                  key: options[:path],
+                  sessionID: options[:token]
+                })
+          end
+
+        private
+
+          def validate_options!(options)
+            missing = []
+            missing << 'token' if options[:token].nil?
+            missing << 'path' if options[:path].nil?
+            missing_str = missing.map { |s| ":#{s}" }.join(', ')
+
+            raise ArgumentError, "Missing required params #{missing_str}" unless missing.empty?
+
+            true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relic_link/coh3/api/endpoints/stats.rb

@@ -33,7 +33,7 @@ module RelicLink
               raise ArgumentError, 'Missing one of required params :profile_ids, :aliases, or :profile_names'
             end
 
-            get('getPersonalStat', array_params(options))
+            get(stats, 'getPersonalStat', array_params(options))
           end
         end
       end

data/lib/relic_link/coh3/api/endpoints.rb

@@ -2,6 +2,7 @@
 
 require_relative 'endpoints/leaderboards'
 require_relative 'endpoints/matches'
+require_relative 'endpoints/replays'
 require_relative 'endpoints/stats'
 
 module RelicLink
@@ -10,6 +11,7 @@ module RelicLink
       module Endpoints
         include Leaderboards
         include Matches
+        include Replays
         include Stats
       end
     end

data/lib/relic_link/coh3/api/errors.rb

@@ -5,6 +5,8 @@ module RelicLink
     module Api
       # Errors specific to the Relic CoH3 API.
       module Errors
+        # Raised when querying for a replay URL with a path that has expired.
+        class ExpiredPath < RelicError; end
         # Raised when querying for a leaderboard that doesn't exist.
         class NotFound < RelicError; end
         # Raised when querying for aliases that don't exist.

data/lib/relic_link/coh3/faraday/connection.rb

@@ -10,13 +10,29 @@ module RelicLink
       module Connection
       private
 
-        def connection
-          @connection ||= ::Faraday.new(
+        def stats
+          @stats ||= ::Faraday.new(
             url: 'https://coh3-api.reliclink.com/community/leaderboard'
           ) do |f|
             f.params[:title] = 'coh3'
 
-            f.use ::RelicLink::Coh3::Faraday::Response::RaiseError
+            f.use ::RelicLink::Coh3::Faraday::Response::RaiseHttpError
+            f.use ::RelicLink::Coh3::Faraday::Response::RaiseStatsError
+            f.response :mashify
+            f.response :json
+            f.use ::RelicLink::Faraday::Response::WrapError
+            f.response :logger, logger if logger
+          end
+        end
+
+        def replays
+          @replays ||= ::Faraday.new(
+            url: 'https://coh3-api.reliclink.com/game/Replay'
+          ) do |f|
+            f.params[:callNum] = rand(5..354)
+
+            f.use ::RelicLink::Coh3::Faraday::Response::RaiseHttpError
+            f.use ::RelicLink::Coh3::Faraday::Response::RaiseReplayError
             f.response :mashify
             f.response :json
             f.use ::RelicLink::Faraday::Response::WrapError

data/lib/relic_link/coh3/faraday/response/raise_http_error.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module RelicLink
+  module Coh3
+    module Faraday
+      module Response
+        # Middleware to catch CoH3 API errors and raise them as exceptions.
+        class RaiseHttpError < ::Faraday::Middleware
+          def on_complete(env)
+            raise RelicLink::Errors::BadRequestError, env.response if env.status == 400
+            raise RelicLink::Errors::UnauthorizedError, env.response if env.status == 401
+            raise RelicLink::Errors::RateLimitError, env.response if env.status == 429
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relic_link/coh3/faraday/response/raise_replay_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module RelicLink
+  module Coh3
+    module Faraday
+      module Response
+        # Middleware to catch CoH3 API errors and raise them as exceptions.
+        class RaiseReplayError < ::Faraday::Middleware
+          def on_complete(env)
+            return unless env.success?
+
+            body = env.body
+            return unless body
+
+            raise RelicLink::Coh3::Api::Errors::ExpiredPath.new('path has expired', env.response) if body.first == 1
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relic_link/coh3/faraday/response/{raise_error.rb → raise_stats_error.rb}

@@ -5,11 +5,8 @@ module RelicLink
     module Faraday
       module Response
         # Middleware to catch CoH3 API errors and raise them as exceptions.
-        class RaiseError < ::Faraday::Middleware
+        class RaiseStatsError < ::Faraday::Middleware
           def on_complete(env)
-            raise RelicLink::Errors::BadRequestError, env.response if env.status == 400
-            raise RelicLink::Errors::RateLimitError, env.response if env.status == 429
-
             return unless env.success?
 
             body = env.body

data/lib/relic_link/errors/server_error.rb

@@ -29,6 +29,13 @@ module RelicLink
       end
     end
 
+    # Raised when a 401 is returned in an API response
+    class UnauthorizedError < HttpRequestError
+      def initialize(response)
+        super('unauthorized', response)
+      end
+    end
+
     # Raised when a 429 is returned in an API response.
     class RateLimitError < HttpRequestError
       def initialize(response)

data/lib/relic_link/faraday/request.rb

@@ -5,7 +5,7 @@ module RelicLink
     # Wrapper for HTTP client +GET+ requests. You should never
     # have to use this directly.
     module Request
-      def get(path, options = {})
+      def get(connection, path, options = {})
         connection.get(path) do |req|
           req.params = req.params.merge(options)
         end.body

data/lib/relic_link/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RelicLink
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
 end

data/lib/relic_link.rb

@@ -11,7 +11,9 @@ require_relative 'relic_link/errors/server_error'
 require_relative 'relic_link/coh3/api/errors/relic_error'
 require_relative 'relic_link/coh3/api/error'
 require_relative 'relic_link/coh3/api/errors'
-require_relative 'relic_link/coh3/faraday/response/raise_error'
+require_relative 'relic_link/coh3/faraday/response/raise_http_error'
+require_relative 'relic_link/coh3/faraday/response/raise_replay_error'
+require_relative 'relic_link/coh3/faraday/response/raise_stats_error'
 require_relative 'relic_link/faraday/response/wrap_error'
 
 require_relative 'relic_link/coh3/util'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relic_link
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - ryantaylor
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-27 00:00:00.000000000 Z
+date: 2024-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -75,6 +75,7 @@ files:
 - lib/relic_link/coh3/api/endpoints/leaderboards/ids.rb
 - lib/relic_link/coh3/api/endpoints/leaderboards/sort.rb
 - lib/relic_link/coh3/api/endpoints/matches.rb
+- lib/relic_link/coh3/api/endpoints/replays.rb
 - lib/relic_link/coh3/api/endpoints/stats.rb
 - lib/relic_link/coh3/api/error.rb
 - lib/relic_link/coh3/api/errors.rb
@@ -82,7 +83,9 @@ files:
 - lib/relic_link/coh3/client.rb
 - lib/relic_link/coh3/config.rb
 - lib/relic_link/coh3/faraday/connection.rb
-- lib/relic_link/coh3/faraday/response/raise_error.rb
+- lib/relic_link/coh3/faraday/response/raise_http_error.rb
+- lib/relic_link/coh3/faraday/response/raise_replay_error.rb
+- lib/relic_link/coh3/faraday/response/raise_stats_error.rb
 - lib/relic_link/coh3/util.rb
 - lib/relic_link/errors/server_error.rb
 - lib/relic_link/faraday/request.rb
@@ -114,7 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.12
+rubygems_version: 3.5.10
 signing_key:
 specification_version: 4
 summary: Wrapper for Relic APIs