Merge pull request #112 from ToshY/bug/111

Added `includeThumbnails` query parameter to Stream API get and list endpoints

Author: ToshY

Diff for: docs/stream-api.md

@@ -34,9 +34,16 @@ $streamApi = new StreamAPI(
 $streamApi->getCollection(
     libraryId: 1,
     collectionId: '97f20caa-649b-4302-9f6e-1d286e0da144',
+    query: [
+        'includeThumbnails' => true,
+    ],
 );
 ```
 
+!!! note
+
+    - If the query parameter `includeThumbnails` is set to `true`, the response item(s) will include a non-empty array key `previewImageUrls` containing the URLs for the corresponding image thumbnails.
+
 #### [Update Collection](https://docs.bunny.net/reference/collection_updatecollection)
 
 ```php
@@ -68,10 +75,15 @@ $streamApi->listCollections(
         'perPage' => 100,
         'search' => 'bunny',
         'orderBy' => 'date',
+        'includeThumbnails' => true,
     ],
 );
 ```
 
+!!! note
+
+    - If the query parameter `includeThumbnails` is set to `true`, the response item(s) will include a non-empty array key `previewImageUrls` containing the URLs for the corresponding image thumbnails.
+
 #### [Create Collection](https://docs.bunny.net/reference/collection_createcollection)
 
 ```php

Diff for: src/Model/API/Stream/ManageCollections/GetCollection.php

@@ -6,9 +6,12 @@
 
 use ToshY\BunnyNet\Enum\Header;
 use ToshY\BunnyNet\Enum\Method;
+use ToshY\BunnyNet\Enum\Type;
+use ToshY\BunnyNet\Model\AbstractParameter;
 use ToshY\BunnyNet\Model\EndpointInterface;
+use ToshY\BunnyNet\Model\EndpointQueryInterface;
 
-class GetCollection implements EndpointInterface
+class GetCollection implements EndpointInterface, EndpointQueryInterface
 {
     public function getMethod(): Method
     {
@@ -26,4 +29,11 @@ public function getHeaders(): array
             Header::ACCEPT_JSON,
         ];
     }
+
+    public function getQuery(): array
+    {
+        return [
+            new AbstractParameter(name: 'includeThumbnails', type: Type::BOOLEAN_TYPE),
+        ];
+    }
 }

Diff for: src/Model/API/Stream/ManageCollections/ListCollections.php

@@ -37,6 +37,7 @@ public function getQuery(): array
             new AbstractParameter(name: 'itemsPerPage', type: Type::INT_TYPE),
             new AbstractParameter(name: 'search', type: Type::STRING_TYPE),
             new AbstractParameter(name: 'orderBy', type: Type::STRING_TYPE),
+            new AbstractParameter(name: 'includeThumbnails', type: Type::BOOLEAN_TYPE),
         ];
     }
 }

Diff for: src/StreamAPI.php

@@ -49,19 +49,27 @@ public function __construct(
      * @throws ClientExceptionInterface
      * @throws Exception\BunnyClientResponseException
      * @throws Exception\JSONException
+     * @throws Exception\InvalidTypeForKeyValueException
+     * @throws Exception\InvalidTypeForListValueException
+     * @throws Exception\ParameterIsRequiredException
      * @param string $collectionId
+     * @param array<string,mixed> $query
      * @return BunnyClientResponseInterface
      * @param int $libraryId
      */
     public function getCollection(
         int $libraryId,
         string $collectionId,
+        array $query = [],
     ): BunnyClientResponseInterface {
         $endpoint = new GetCollection();
 
+        ParameterValidator::validate($query, $endpoint->getQuery());
+
         return $this->client->request(
             endpoint: $endpoint,
             parameters: [$libraryId, $collectionId],
+            query: $query,
         );
     }