trophy_api_client 1.0.20 → 1.0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a79a94b140eb840c0a0b4f40f855c69fbb66bb429977154f144ef1e5f1b37729
-  data.tar.gz: d712f9760544029301467b699433584ceaddf2faf12a3122475d1de9630ca7ae
+  metadata.gz: 68357394d52195a47c44fc9355befe6eca436547e932e74dd0efa10f7c01821e
+  data.tar.gz: d081f45005de17054f0acefc19e113e0a7788b73e8e3c1e942e66b7dbb4d90ee
 SHA512:
-  metadata.gz: 23d14322f1451cc839c440cb727a5549439ae5c09f5869e09519db7a6bc0f562426acb200d67b1a11390d8b0a2af047ab60a1e7aea1de59c43a747db7f2c7b20
-  data.tar.gz: 53ea20d8432d15b2b64834927d74c1eba36b2912f10654325fbf81456ee68460442f523cc82af9b5077bcb0cc154d27cbac901c58e224e7a2255aa18da1d3d01
+  metadata.gz: d955c1f044f150e062e4740398028483d22935eb76a475f45a7fc13118767c6b6c3f2ac4dd032b7cd7a013e8e2aae7113598efe220c4e9f4d1f6fc0b1531894d
+  data.tar.gz: b5b9402673a5981686b77aae50db69e28ddb683dddcd2db4a02471e23299868313361dcaa683d4ce9128cd767476854fe6d6e57bc9d925ac1e9ea9e0c3c7ded9

data/lib/gemconfig.rb

@@ -2,7 +2,7 @@
 
 module TrophyApiClient
   module Gemconfig
-    VERSION = "1.0.20"
+    VERSION = "1.0.21"
     AUTHORS = ["Trophy Labs, Inc"].freeze
     EMAIL = ""
     SUMMARY = "Ruby library for the Trophy API."

data/lib/trophy_api_client/streaks/client.rb

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
 require_relative "../../requests"
+require_relative "../types/bulk_streak_response"
+require "json"
 require_relative "types/streaks_rankings_request_type"
 require_relative "../types/streak_ranking_user"
-require "json"
 require "async"
 
 module TrophyApiClient
@@ -17,6 +18,41 @@ module TrophyApiClient
       @request_client = request_client
     end
 
+    # Get the streak lengths of a list of users, ranked by streak length from longest
+    #  to shortest.
+    #
+    # @param user_ids [String] A list of up to 100 user IDs.
+    # @param request_options [TrophyApiClient::RequestOptions]
+    # @return [TrophyApiClient::BULK_STREAK_RESPONSE]
+    # @example
+    #  api = TrophyApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: TrophyApiClient::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.streaks.list
+    def list(user_ids: nil, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = { **(request_options&.additional_query_parameters || {}), "userIds": user_ids }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/streaks"
+      end
+      parsed_json = JSON.parse(response.body)
+      parsed_json&.map do |item|
+        item = item.to_json
+        TrophyApiClient::BulkStreakResponseItem.from_json(json_object: item)
+      end
+    end
+
     # Get the top users by streak length (active or longest).
     #
     # @param limit [Integer] Number of users to return. Must be between 1 and 100.
@@ -63,6 +99,43 @@ module TrophyApiClient
       @request_client = request_client
     end
 
+    # Get the streak lengths of a list of users, ranked by streak length from longest
+    #  to shortest.
+    #
+    # @param user_ids [String] A list of up to 100 user IDs.
+    # @param request_options [TrophyApiClient::RequestOptions]
+    # @return [TrophyApiClient::BULK_STREAK_RESPONSE]
+    # @example
+    #  api = TrophyApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: TrophyApiClient::Environment::DEFAULT,
+    #    api_key: "YOUR_API_KEY"
+    #  )
+    #  api.streaks.list
+    def list(user_ids: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = { **(request_options&.additional_query_parameters || {}), "userIds": user_ids }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/streaks"
+        end
+        parsed_json = JSON.parse(response.body)
+        parsed_json&.map do |item|
+          item = item.to_json
+          TrophyApiClient::BulkStreakResponseItem.from_json(json_object: item)
+        end
+      end
+    end
+
     # Get the top users by streak length (active or longest).
     #
     # @param limit [Integer] Number of users to return. Must be between 1 and 100.

data/lib/trophy_api_client/types/bulk_streak_response.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "bulk_streak_response_item"
+
+module TrophyApiClient
+  BULK_STREAK_RESPONSE = Array
+end

data/lib/trophy_api_client/types/bulk_streak_response_item.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module TrophyApiClient
+  class BulkStreakResponseItem
+    # @return [String] The ID of the user.
+    attr_reader :user_id
+    # @return [Integer] The length of the user's streak.
+    attr_reader :streak_length
+    # @return [String] The timestamp the streak was extended, as a string.
+    attr_reader :extended
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param user_id [String] The ID of the user.
+    # @param streak_length [Integer] The length of the user's streak.
+    # @param extended [String] The timestamp the streak was extended, as a string.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [TrophyApiClient::BulkStreakResponseItem]
+    def initialize(user_id:, streak_length:, extended: OMIT, additional_properties: nil)
+      @user_id = user_id
+      @streak_length = streak_length
+      @extended = extended if extended != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "userId": user_id, "streakLength": streak_length, "extended": extended }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of BulkStreakResponseItem
+    #
+    # @param json_object [String]
+    # @return [TrophyApiClient::BulkStreakResponseItem]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      user_id = parsed_json["userId"]
+      streak_length = parsed_json["streakLength"]
+      extended = parsed_json["extended"]
+      new(
+        user_id: user_id,
+        streak_length: streak_length,
+        extended: extended,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of BulkStreakResponseItem to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.user_id.is_a?(String) != false || raise("Passed value for field obj.user_id is not the expected type, validation failed.")
+      obj.streak_length.is_a?(Integer) != false || raise("Passed value for field obj.streak_length is not the expected type, validation failed.")
+      obj.extended&.is_a?(String) != false || raise("Passed value for field obj.extended is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/trophy_api_client/version.rb

@@ -1,3 +1,3 @@
 module MyGem
-  VERSION = "1.0.20"
+  VERSION = "1.0.21"
 end

data/lib/types_export.rb

@@ -8,6 +8,8 @@ require_relative "trophy_api_client/streaks/types/streaks_rankings_request_type"
 require_relative "trophy_api_client/types/metric_status"
 require_relative "trophy_api_client/types/streak_frequency"
 require_relative "trophy_api_client/types/base_streak_response"
+require_relative "trophy_api_client/types/bulk_streak_response_item"
+require_relative "trophy_api_client/types/bulk_streak_response"
 require_relative "trophy_api_client/types/metric_event_streak_response"
 require_relative "trophy_api_client/types/streak_response_streak_history_item"
 require_relative "trophy_api_client/types/streak_response"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trophy_api_client
 version: !ruby/object:Gem::Version
-  version: 1.0.20
+  version: 1.0.21
 platform: ruby
 authors:
 - Trophy Labs, Inc
@@ -111,6 +111,8 @@ files:
 - lib/trophy_api_client/types/achievement_with_stats_response_event_attribute.rb
 - lib/trophy_api_client/types/achievement_with_stats_response_user_attributes_item.rb
 - lib/trophy_api_client/types/base_streak_response.rb
+- lib/trophy_api_client/types/bulk_streak_response.rb
+- lib/trophy_api_client/types/bulk_streak_response_item.rb
 - lib/trophy_api_client/types/completed_achievement_response.rb
 - lib/trophy_api_client/types/error_body.rb
 - lib/trophy_api_client/types/event_response.rb