Automatically update Dotnet SDK

github-actions[bot] · github-actions[bot] · commit 03103a408dcb · 2026-03-25T10:21:58.000Z
diff --git a/src/TrophyApi.sln b/src/TrophyApi.sln
@@ -3,9 +3,9 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.0.31903.59
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrophyApi", "TrophyApi\TrophyApi.csproj", "{90DCDF52-396C-4033-832C-23C0CAA3D03B}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrophyApi", "TrophyApi\TrophyApi.csproj", "{908F274A-7409-48B0-A378-AD663AD96C5B}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrophyApi.Test", "TrophyApi.Test\TrophyApi.Test.csproj", "{FD302654-5EB4-43DB-AF40-0ACB9279DB75}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TrophyApi.Test", "TrophyApi.Test\TrophyApi.Test.csproj", "{F701FD29-82A0-4A05-8767-1C12E372A04E}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -16,13 +16,13 @@ Global
 		HideSolutionNode = FALSE
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{90DCDF52-396C-4033-832C-23C0CAA3D03B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{90DCDF52-396C-4033-832C-23C0CAA3D03B}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{90DCDF52-396C-4033-832C-23C0CAA3D03B}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{90DCDF52-396C-4033-832C-23C0CAA3D03B}.Release|Any CPU.Build.0 = Release|Any CPU
-		{FD302654-5EB4-43DB-AF40-0ACB9279DB75}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{FD302654-5EB4-43DB-AF40-0ACB9279DB75}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{FD302654-5EB4-43DB-AF40-0ACB9279DB75}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{FD302654-5EB4-43DB-AF40-0ACB9279DB75}.Release|Any CPU.Build.0 = Release|Any CPU
+		{908F274A-7409-48B0-A378-AD663AD96C5B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{908F274A-7409-48B0-A378-AD663AD96C5B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{908F274A-7409-48B0-A378-AD663AD96C5B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{908F274A-7409-48B0-A378-AD663AD96C5B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F701FD29-82A0-4A05-8767-1C12E372A04E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F701FD29-82A0-4A05-8767-1C12E372A04E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F701FD29-82A0-4A05-8767-1C12E372A04E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F701FD29-82A0-4A05-8767-1C12E372A04E}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 EndGlobal
diff --git a/src/TrophyApi/Points/PointsClient.cs b/src/TrophyApi/Points/PointsClient.cs
@@ -226,4 +226,138 @@ public async Task<IEnumerable<PointsBoost>> BoostsAsync(
             );
         }
     }
+
+    /// <summary>
+    /// Get all levels for a points system.
+    /// </summary>
+    /// <example><code>
+    /// await client.Points.LevelsAsync("points-system-key");
+    /// </code></example>
+    public async Task<IEnumerable<PointsLevel>> LevelsAsync(
+        string key,
+        RequestOptions? options = null,
+        CancellationToken cancellationToken = default
+    )
+    {
+        var response = await _client
+            .SendRequestAsync(
+                new JsonRequest
+                {
+                    BaseUrl = _client.Options.Environment.Api,
+                    Method = HttpMethod.Get,
+                    Path = string.Format(
+                        "points/{0}/levels",
+                        ValueConvert.ToPathParameterString(key)
+                    ),
+                    Options = options,
+                },
+                cancellationToken
+            )
+            .ConfigureAwait(false);
+        if (response.StatusCode is >= 200 and < 400)
+        {
+            var responseBody = await response.Raw.Content.ReadAsStringAsync();
+            try
+            {
+                return JsonUtils.Deserialize<IEnumerable<PointsLevel>>(responseBody)!;
+            }
+            catch (JsonException e)
+            {
+                throw new TrophyApiException("Failed to deserialize response", e);
+            }
+        }
+
+        {
+            var responseBody = await response.Raw.Content.ReadAsStringAsync();
+            try
+            {
+                switch (response.StatusCode)
+                {
+                    case 401:
+                        throw new UnauthorizedError(JsonUtils.Deserialize<ErrorBody>(responseBody));
+                    case 404:
+                        throw new NotFoundError(JsonUtils.Deserialize<ErrorBody>(responseBody));
+                }
+            }
+            catch (JsonException)
+            {
+                // unable to map error response, throwing generic error
+            }
+            throw new TrophyApiApiException(
+                $"Error with status code {response.StatusCode}",
+                response.StatusCode,
+                responseBody
+            );
+        }
+    }
+
+    /// <summary>
+    /// Get a breakdown of the number of users at each level in a points system.
+    /// </summary>
+    /// <example><code>
+    /// await client.Points.LevelSummaryAsync("points-system-key");
+    /// </code></example>
+    public async Task<IEnumerable<PointsLevelSummaryResponseItem>> LevelSummaryAsync(
+        string key,
+        RequestOptions? options = null,
+        CancellationToken cancellationToken = default
+    )
+    {
+        var response = await _client
+            .SendRequestAsync(
+                new JsonRequest
+                {
+                    BaseUrl = _client.Options.Environment.Api,
+                    Method = HttpMethod.Get,
+                    Path = string.Format(
+                        "points/{0}/level-summary",
+                        ValueConvert.ToPathParameterString(key)
+                    ),
+                    Options = options,
+                },
+                cancellationToken
+            )
+            .ConfigureAwait(false);
+        if (response.StatusCode is >= 200 and < 400)
+        {
+            var responseBody = await response.Raw.Content.ReadAsStringAsync();
+            try
+            {
+                return JsonUtils.Deserialize<IEnumerable<PointsLevelSummaryResponseItem>>(
+                    responseBody
+                )!;
+            }
+            catch (JsonException e)
+            {
+                throw new TrophyApiException("Failed to deserialize response", e);
+            }
+        }
+
+        {
+            var responseBody = await response.Raw.Content.ReadAsStringAsync();
+            try
+            {
+                switch (response.StatusCode)
+                {
+                    case 401:
+                        throw new UnauthorizedError(JsonUtils.Deserialize<ErrorBody>(responseBody));
+                    case 404:
+                        throw new NotFoundError(JsonUtils.Deserialize<ErrorBody>(responseBody));
+                    case 422:
+                        throw new UnprocessableEntityError(
+                            JsonUtils.Deserialize<ErrorBody>(responseBody)
+                        );
+                }
+            }
+            catch (JsonException)
+            {
+                // unable to map error response, throwing generic error
+            }
+            throw new TrophyApiApiException(
+                $"Error with status code {response.StatusCode}",
+                response.StatusCode,
+                responseBody
+            );
+        }
+    }
 }
diff --git a/src/TrophyApi/TrophyApi.csproj b/src/TrophyApi/TrophyApi.csproj
@@ -9,7 +9,7 @@
 
         <!-- 🔹 NuGet Metadata -->
         <PackageId>Trophy</PackageId>
-        <Version>1.1.2</Version>
+        <Version>1.2.1</Version>
         <Authors>Trophy Labs, Inc</Authors>
         <Description>.NET SDK for the Trophy API</Description>
         <PackageTags>trophy; api; gamification; sdk</PackageTags>
diff --git a/src/TrophyApi/Types/GetUserPointsResponse.cs b/src/TrophyApi/Types/GetUserPointsResponse.cs
@@ -7,6 +7,24 @@ namespace TrophyApi;
 [Serializable]
 public record GetUserPointsResponse
 {
+    /// <summary>
+    /// The user's total points
+    /// </summary>
+    [JsonPropertyName("total")]
+    public required int Total { get; set; }
+
+    /// <summary>
+    /// The user's current level in this points system, or null if no levels are configured or the user hasn't reached any level yet.
+    /// </summary>
+    [JsonPropertyName("level")]
+    public PointsLevel? Level { get; set; }
+
+    /// <summary>
+    /// Array of trigger awards that added points.
+    /// </summary>
+    [JsonPropertyName("awards")]
+    public IEnumerable<PointsAward> Awards { get; set; } = new List<PointsAward>();
+
     /// <summary>
     /// The ID of the points system
     /// </summary>
@@ -43,18 +61,6 @@ public record GetUserPointsResponse
     [JsonPropertyName("maxPoints")]
     public double? MaxPoints { get; set; }
 
-    /// <summary>
-    /// The user's total points
-    /// </summary>
-    [JsonPropertyName("total")]
-    public required int Total { get; set; }
-
-    /// <summary>
-    /// Array of trigger awards that added points.
-    /// </summary>
-    [JsonPropertyName("awards")]
-    public IEnumerable<PointsAward> Awards { get; set; } = new List<PointsAward>();
-
     /// <summary>
     /// Additional properties received from the response, if any.
     /// </summary>
diff --git a/src/TrophyApi/Types/MetricEventPointsResponse.cs b/src/TrophyApi/Types/MetricEventPointsResponse.cs
@@ -5,11 +5,35 @@
 namespace TrophyApi;
 
 /// <summary>
-/// Points system response for metric events.
+/// Points system response for metric events and achievement completions.
 /// </summary>
 [Serializable]
 public record MetricEventPointsResponse
 {
+    /// <summary>
+    /// The user's total points
+    /// </summary>
+    [JsonPropertyName("total")]
+    public required int Total { get; set; }
+
+    /// <summary>
+    /// The user's new level, included only when the level changed as a result of this event.
+    /// </summary>
+    [JsonPropertyName("level")]
+    public PointsLevel? Level { get; set; }
+
+    /// <summary>
+    /// The points added by this event.
+    /// </summary>
+    [JsonPropertyName("added")]
+    public required int Added { get; set; }
+
+    /// <summary>
+    /// Array of trigger awards that added points.
+    /// </summary>
+    [JsonPropertyName("awards")]
+    public IEnumerable<PointsAward> Awards { get; set; } = new List<PointsAward>();
+
     /// <summary>
     /// The ID of the points system
     /// </summary>
@@ -46,24 +70,6 @@ public record MetricEventPointsResponse
     [JsonPropertyName("maxPoints")]
     public double? MaxPoints { get; set; }
 
-    /// <summary>
-    /// The user's total points
-    /// </summary>
-    [JsonPropertyName("total")]
-    public required int Total { get; set; }
-
-    /// <summary>
-    /// The points added by this event.
-    /// </summary>
-    [JsonPropertyName("added")]
-    public required int Added { get; set; }
-
-    /// <summary>
-    /// Array of trigger awards that added points.
-    /// </summary>
-    [JsonPropertyName("awards")]
-    public IEnumerable<PointsAward> Awards { get; set; } = new List<PointsAward>();
-
     /// <summary>
     /// Additional properties received from the response, if any.
     /// </summary>
diff --git a/src/TrophyApi/Types/PointsLevel.cs b/src/TrophyApi/Types/PointsLevel.cs
@@ -0,0 +1,64 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using TrophyApi.Core;
+
+namespace TrophyApi;
+
+/// <summary>
+/// A level within a points system.
+/// </summary>
+[Serializable]
+public record PointsLevel
+{
+    /// <summary>
+    /// The ID of the level
+    /// </summary>
+    [JsonPropertyName("id")]
+    public required string Id { get; set; }
+
+    /// <summary>
+    /// The unique key of the level
+    /// </summary>
+    [JsonPropertyName("key")]
+    public required string Key { get; set; }
+
+    /// <summary>
+    /// The name of the level
+    /// </summary>
+    [JsonPropertyName("name")]
+    public required string Name { get; set; }
+
+    /// <summary>
+    /// The description of the level
+    /// </summary>
+    [JsonPropertyName("description")]
+    public required string Description { get; set; }
+
+    /// <summary>
+    /// The URL of the badge image for the level
+    /// </summary>
+    [JsonPropertyName("badgeUrl")]
+    public string? BadgeUrl { get; set; }
+
+    /// <summary>
+    /// The points threshold required to reach this level
+    /// </summary>
+    [JsonPropertyName("points")]
+    public required int Points { get; set; }
+
+    /// <summary>
+    /// Additional properties received from the response, if any.
+    /// </summary>
+    /// <remarks>
+    /// [EXPERIMENTAL] This API is experimental and may change in future releases.
+    /// </remarks>
+    [JsonExtensionData]
+    public IDictionary<string, JsonElement> AdditionalProperties { get; internal set; } =
+        new Dictionary<string, JsonElement>();
+
+    /// <inheritdoc />
+    public override string ToString()
+    {
+        return JsonUtils.Serialize(this);
+    }
+}
diff --git a/src/TrophyApi/Types/PointsLevelSummaryResponseItem.cs b/src/TrophyApi/Types/PointsLevelSummaryResponseItem.cs
@@ -0,0 +1,34 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using TrophyApi.Core;
+
+namespace TrophyApi;
+
+[Serializable]
+public record PointsLevelSummaryResponseItem
+{
+    [JsonPropertyName("level")]
+    public required PointsLevel Level { get; set; }
+
+    /// <summary>
+    /// The number of users currently at this level
+    /// </summary>
+    [JsonPropertyName("users")]
+    public required int Users { get; set; }
+
+    /// <summary>
+    /// Additional properties received from the response, if any.
+    /// </summary>
+    /// <remarks>
+    /// [EXPERIMENTAL] This API is experimental and may change in future releases.
+    /// </remarks>
+    [JsonExtensionData]
+    public IDictionary<string, JsonElement> AdditionalProperties { get; internal set; } =
+        new Dictionary<string, JsonElement>();
+
+    /// <inheritdoc />
+    public override string ToString()
+    {
+        return JsonUtils.Serialize(this);
+    }
+}
diff --git a/src/TrophyApi/Types/PointsResponse.cs b/src/TrophyApi/Types/PointsResponse.cs
diff --git a/src/TrophyApi/Types/WebhooksPointsLevelChangedPayload.cs b/src/TrophyApi/Types/WebhooksPointsLevelChangedPayload.cs
diff --git a/src/TrophyApi/Types/WebhooksPointsLevelChangedPayloadPoints.cs b/src/TrophyApi/Types/WebhooksPointsLevelChangedPayloadPoints.cs
