trophy_api_client 1.0.20 → 1.0.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a79a94b140eb840c0a0b4f40f855c69fbb66bb429977154f144ef1e5f1b37729
-  data.tar.gz: d712f9760544029301467b699433584ceaddf2faf12a3122475d1de9630ca7ae
+  metadata.gz: cab733c24577e49524eb7899160b7c172195e0d2e84b3b6cd11cadb32342ee9a
+  data.tar.gz: a3999029f59148a4208edf380c131f9c9539c51fd9512e3f7f9fdd5e58270b06
 SHA512:
-  metadata.gz: 23d14322f1451cc839c440cb727a5549439ae5c09f5869e09519db7a6bc0f562426acb200d67b1a11390d8b0a2af047ab60a1e7aea1de59c43a747db7f2c7b20
-  data.tar.gz: 53ea20d8432d15b2b64834927d74c1eba36b2912f10654325fbf81456ee68460442f523cc82af9b5077bcb0cc154d27cbac901c58e224e7a2255aa18da1d3d01
+  metadata.gz: dcb1a2eab70038ac53d6d85ef7f8267a17b29dbba682f4fd44d2af7bb7d88243c85d34adf337775b24d494ee7124e8cdf77d3cba64492908eb03293374821d0a
+  data.tar.gz: c173eacb9c7c5be6cd6cc540c055ecb3f7bfb1c811f20c3f143e838f3a01dd1bd287d2fc920b9e5f2a73547494b6e22b7e28fd6e78339dcdd279acde449c1940

data/lib/gemconfig.rb

@@ -2,7 +2,7 @@
 
 module TrophyApiClient
   module Gemconfig
-    VERSION = "1.0.20"
+    VERSION = "1.0.22"
     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/types/event_response.rb

@@ -19,6 +19,10 @@ module TrophyApiClient
     attr_reader :current_streak
     # @return [Hash{String => TrophyApiClient::MetricEventPointsResponse}] A map of points systems by key that were affected by this event.
     attr_reader :points
+    # @return [String] The idempotency key used for the event, if one was provided.
+    attr_reader :idempotency_key
+    # @return [Boolean] Whether the event was replayed due to idempotency.
+    attr_reader :idempotent_replayed
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -33,16 +37,20 @@ module TrophyApiClient
     # @param achievements [Array<TrophyApiClient::CompletedAchievementResponse>] Achievements completed as a result of this event.
     # @param current_streak [TrophyApiClient::MetricEventStreakResponse] The user's current streak for the metric, if the metric has streaks enabled.
     # @param points [Hash{String => TrophyApiClient::MetricEventPointsResponse}] A map of points systems by key that were affected by this event.
+    # @param idempotency_key [String] The idempotency key used for the event, if one was provided.
+    # @param idempotent_replayed [Boolean] Whether the event was replayed due to idempotency.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::EventResponse]
     def initialize(event_id:, metric_id:, total:, achievements: OMIT, current_streak: OMIT, points: OMIT,
-                   additional_properties: nil)
+                   idempotency_key: OMIT, idempotent_replayed: OMIT, additional_properties: nil)
       @event_id = event_id
       @metric_id = metric_id
       @total = total
       @achievements = achievements if achievements != OMIT
       @current_streak = current_streak if current_streak != OMIT
       @points = points if points != OMIT
+      @idempotency_key = idempotency_key if idempotency_key != OMIT
+      @idempotent_replayed = idempotent_replayed if idempotent_replayed != OMIT
       @additional_properties = additional_properties
       @_field_set = {
         "eventId": event_id,
@@ -50,7 +58,9 @@ module TrophyApiClient
         "total": total,
         "achievements": achievements,
         "currentStreak": current_streak,
-        "points": points
+        "points": points,
+        "idempotencyKey": idempotency_key,
+        "idempotentReplayed": idempotent_replayed
       }.reject do |_k, v|
         v == OMIT
       end
@@ -80,6 +90,8 @@ module TrophyApiClient
         value = value.to_json
         TrophyApiClient::MetricEventPointsResponse.from_json(json_object: value)
       end
+      idempotency_key = parsed_json["idempotencyKey"]
+      idempotent_replayed = parsed_json["idempotentReplayed"]
       new(
         event_id: event_id,
         metric_id: metric_id,
@@ -87,6 +99,8 @@ module TrophyApiClient
         achievements: achievements,
         current_streak: current_streak,
         points: points,
+        idempotency_key: idempotency_key,
+        idempotent_replayed: idempotent_replayed,
         additional_properties: struct
       )
     end
@@ -111,6 +125,8 @@ module TrophyApiClient
       obj.achievements&.is_a?(Array) != false || raise("Passed value for field obj.achievements is not the expected type, validation failed.")
       obj.current_streak.nil? || TrophyApiClient::MetricEventStreakResponse.validate_raw(obj: obj.current_streak)
       obj.points&.is_a?(Hash) != false || raise("Passed value for field obj.points is not the expected type, validation failed.")
+      obj.idempotency_key&.is_a?(String) != false || raise("Passed value for field obj.idempotency_key is not the expected type, validation failed.")
+      obj.idempotent_replayed&.is_a?(Boolean) != false || raise("Passed value for field obj.idempotent_replayed 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.22"
 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.22
 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