Automatically update PHP SDK

Author: github-actions[bot]

composer.json

@@ -1,6 +1,6 @@
 {
   "name": "trophy/php",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "Trophy PHP Library",
   "keywords": [
     "trophy",

src/Streaks/Requests/StreaksListRequest.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Trophy\Streaks\Requests;
+
+use Trophy\Core\Json\JsonSerializableType;
+
+class StreaksListRequest extends JsonSerializableType
+{
+    /**
+     * @var array<?string> $userIds A list of up to 100 user IDs.
+     */
+    public array $userIds;
+
+    /**
+     * @param array{
+     *   userIds: array<?string>,
+     * } $values
+     */
+    public function __construct(
+        array $values,
+    ) {
+        $this->userIds = $values['userIds'];
+    }
+}

src/Streaks/StreaksClient.php

@@ -4,8 +4,8 @@
 
 use GuzzleHttp\ClientInterface;
 use Trophy\Core\Client\RawClient;
-use Trophy\Streaks\Requests\StreaksRankingsRequest;
-use Trophy\Types\StreakRankingUser;
+use Trophy\Streaks\Requests\StreaksListRequest;
+use Trophy\Types\BulkStreakResponseItem;
 use Trophy\Exceptions\TrophyException;
 use Trophy\Exceptions\TrophyApiException;
 use Trophy\Core\Json\JsonApiRequest;
@@ -15,6 +15,8 @@
 use JsonException;
 use GuzzleHttp\Exception\RequestException;
 use Psr\Http\Client\ClientExceptionInterface;
+use Trophy\Streaks\Requests\StreaksRankingsRequest;
+use Trophy\Types\StreakRankingUser;
 
 class StreaksClient
 {
@@ -50,6 +52,62 @@ public function __construct(
         $this->options = $options ?? [];
     }
 
+    /**
+     * Get the streak lengths of a list of users, ranked by streak length from longest to shortest.
+     *
+     * @param StreaksListRequest $request
+     * @param ?array{
+     *   baseUrl?: string,
+     *   maxRetries?: int,
+     * } $options
+     * @return array<BulkStreakResponseItem>
+     * @throws TrophyException
+     * @throws TrophyApiException
+     */
+    public function list(StreaksListRequest $request, ?array $options = null): array
+    {
+        $options = array_merge($this->options, $options ?? []);
+        $query = [];
+        if ($request->userIds != null) {
+            $query['userIds'] = $request->userIds;
+        }
+        try {
+            $response = $this->client->sendRequest(
+                new JsonApiRequest(
+                    baseUrl: $options['baseUrl'] ?? $this->client->options['baseUrl'] ?? Environments::Default_->value,
+                    path: "streaks",
+                    method: HttpMethod::GET,
+                    query: $query,
+                ),
+                $options,
+            );
+            $statusCode = $response->getStatusCode();
+            if ($statusCode >= 200 && $statusCode < 400) {
+                $json = $response->getBody()->getContents();
+                return JsonDecoder::decodeArray($json, [BulkStreakResponseItem::class]); // @phpstan-ignore-line
+            }
+        } catch (JsonException $e) {
+            throw new TrophyException(message: "Failed to deserialize response: {$e->getMessage()}", previous: $e);
+        } catch (RequestException $e) {
+            $response = $e->getResponse();
+            if ($response === null) {
+                throw new TrophyException(message: $e->getMessage(), previous: $e);
+            }
+            throw new TrophyApiException(
+                message: "API request failed",
+                statusCode: $response->getStatusCode(),
+                body: $response->getBody()->getContents(),
+            );
+        } catch (ClientExceptionInterface $e) {
+            throw new TrophyException(message: $e->getMessage(), previous: $e);
+        }
+        throw new TrophyApiException(
+            message: 'API request failed',
+            statusCode: $statusCode,
+            body: $response->getBody()->getContents(),
+        );
+    }
+
     /**
      * Get the top users by streak length (active or longest).
      *

src/Types/BulkStreakResponseItem.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Trophy\Types;
+
+use Trophy\Core\Json\JsonSerializableType;
+use Trophy\Core\Json\JsonProperty;
+
+class BulkStreakResponseItem extends JsonSerializableType
+{
+    /**
+     * @var string $userId The ID of the user.
+     */
+    #[JsonProperty('userId')]
+    public string $userId;
+
+    /**
+     * @var int $streakLength The length of the user's streak.
+     */
+    #[JsonProperty('streakLength')]
+    public int $streakLength;
+
+    /**
+     * @var ?string $extended The timestamp the streak was extended, as a string.
+     */
+    #[JsonProperty('extended')]
+    public ?string $extended;
+
+    /**
+     * @param array{
+     *   userId: string,
+     *   streakLength: int,
+     *   extended?: ?string,
+     * } $values
+     */
+    public function __construct(
+        array $values,
+    ) {
+        $this->userId = $values['userId'];
+        $this->streakLength = $values['streakLength'];
+        $this->extended = $values['extended'] ?? null;
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return $this->toJson();
+    }
+}