[Improvement]: Retrieving thumbnail URLs via GraphQL API triggers thumbnail generation

doc/10_GraphQL/04_Query/04_Asset_Queries.md

@@ -92,3 +92,35 @@ For details see [filtering documentation page](./10_Filtering.md)
 ## Localization of Queries
 Queries can be localized For details see the [localization documentation page](./08_Localization.md).
 
+## Thumbnails
+
+You can request thumbnails for assets using a simple query like this:
+
+#### Video assets thumbnails
+
+You need to specify the name of the video thumbnail configuration you want to use.
+Additionally, you can use the `format` parameter to request a specific format.
+
+```graphql
+query {
+  getAsset(id:353) {
+    id,    
+    thumbnail:fullpath(thumbnail: "content"),    
+  }
+}
+```
+
+#### Image assets thumbnails
+
+You need to specify the name of the video thumbnail configuration you want to use.
+Use the `format` parameter to request a specific format.
+Specifying the `deferred` parameter will defer the thumbnail generation until it gets requested for the first time.
+
+```graphql
+query {
+  getAsset(id:289) {
+    id,    
+    thumbnail:fullpath(thumbnail: "events_header", deferred:true)    
+  }
+}
+```

src/GraphQL/AssetType/AssetType.php

@@ -98,6 +98,7 @@ public function build(&$config)
                 'args' => [
                     'thumbnail' => ['type' => Type::string()],
                     'format' => ['type' => Type::string()],
+                    'deferred' => ['type' => Type::boolean(), 'defaultValue' => false],
                 ],
                 'resolve' => [$resolver, 'resolvePath'],
             ],
@@ -140,6 +141,7 @@ public function build(&$config)
                 'args' => [
                     'thumbnail' => ['type' => Type::nonNull(Type::string())],
                     'format' => ['type' => Type::string()],
+                    'deferred' => ['type' => Type::boolean(), 'defaultValue' => false],
                 ],
                 'resolve' => [$resolver, 'resolveSrcSet'],
             ],

src/GraphQL/FieldHelper/AssetFieldHelper.php

@@ -41,28 +41,47 @@ public function getVideoThumbnail(Asset\Video $asset, string | Video\Thumbnail\C
         return null;
     }
 
-    public function getImageDocumentThumbnail(Asset $asset, string | Image\Thumbnail\Config $thumbNailConfig, string $thumbNailFormat = null): mixed
-    {
+    public function getImageDocumentThumbnail(
+        Asset $asset,
+        string | Image\Thumbnail\Config $thumbNailConfig,
+        string $thumbNailFormat = null,
+        bool $deferred = false
+    ): mixed {
         $thumb = null;
 
-        if ($asset instanceof Asset\Document || $asset instanceof Asset\Video) {
+        if ($asset instanceof Asset\Document) {
+            $thumb = $asset->getImageThumbnail($thumbNailConfig, deferred: $deferred);
+        }
+
+        if ($asset instanceof Asset\Video) {
             $thumb = $asset->getImageThumbnail($thumbNailConfig);
-        } elseif ($asset instanceof Asset\Image) {
-            $thumb = $asset->getThumbnail($thumbNailConfig, false);
         }
-        if (isset($thumb, $thumbNailFormat) && method_exists($thumb, 'getAsFormat') && !($asset instanceof Asset\Video)) {
+
+        if ($asset instanceof Asset\Image) {
+            $thumb = $asset->getThumbnail($thumbNailConfig, $deferred);
+        }
+
+        if (
+            !($asset instanceof Asset\Video) &&
+            isset($thumb, $thumbNailFormat) &&
+            method_exists($thumb, 'getAsFormat')
+        ) {
             $thumb = $thumb->getAsFormat($thumbNailFormat);
         }
 
         return $thumb;
     }
 
-    public function getAssetThumbnail(Asset $asset, string | Image\Thumbnail\Config | Video\Thumbnail\Config $thumbNailConfig, string $thumbNailFormat = null): mixed
-    {
+    public function getAssetThumbnail(
+        Asset $asset,
+        string | Image\Thumbnail\Config | Video\Thumbnail\Config $thumbNailConfig,
+        string $thumbNailFormat = null,
+        bool $deferred = false
+    ): mixed {
         if (($asset instanceof Asset\Video) && (is_string($thumbNailConfig) || $thumbNailConfig instanceof Video\Thumbnail\Config)) {
             return $this->getVideoThumbnail($asset, $thumbNailConfig, $thumbNailFormat);
         } else {
-            return $this->getImageDocumentThumbnail($asset, $thumbNailConfig, $thumbNailFormat);
+            return $this->getImageDocumentThumbnail($asset, $thumbNailConfig, $thumbNailFormat, $deferred);
         }
     }
 

src/GraphQL/Resolver/AssetType.php

@@ -147,13 +147,14 @@ public function resolvePath($value = null, $args = [], $context = [], ResolveInf
         $asset = $this->getAssetFromValue($value, $context);
         $thumbNailConfig = $args['thumbnail'] ?? null;
         $thumbNailFormat = $args['format'] ?? null;
+        $deferred = $args['deferred'] ?? false;
         $assetFieldHelper = $this->getGraphQLService()->getAssetFieldHelper();
 
         if (!isset($thumbNailConfig)) {
             return $asset->getFullPath();
         }
 
-        return $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat);
+        return $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat, $deferred);
     }
 
     /**
@@ -170,12 +171,13 @@ public function resolveData($value = null, $args = [], $context = [], ResolveInf
         $asset = $this->getAssetFromValue($value, $context);
         $thumbNailConfig = $args['thumbnail'] ?? null;
         $thumbNailFormat = $args['format'] ?? null;
+        $deferred = $args['deferred'] ?? false;
         $assetFieldHelper = $this->getGraphQLService()->getAssetFieldHelper();
 
         if (!isset($thumbNailConfig)) {
             return base64_encode(stream_get_contents($asset->getStream()));
         }
-        $thumb = $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat);
+        $thumb = $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat, $deferred);
 
         return $thumb ? base64_encode(stream_get_contents($thumb->getStream())) : base64_encode(stream_get_contents($asset->getStream()));
     }
@@ -194,12 +196,13 @@ public function resolveSrcSet($value = null, $args = [], $context = [], ResolveI
         $asset = $this->getAssetFromValue($value, $context);
         $thumbNailConfig = $args['thumbnail'] ?? null;
         $thumbNailFormat = $args['format'] ?? null;
+        $deferred = $args['deferred'] ?? null;
         $assetFieldHelper = $this->getGraphQLService()->getAssetFieldHelper();
 
         if ($asset instanceof Asset\Image) {
             $mediaQueries = [];
-            $thumbnail = $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat);
-            $thumbnailConfig = $asset->getThumbnail($args['thumbnail'])->getConfig();
+            $thumbnail = $assetFieldHelper->getAssetThumbnail($asset, $thumbNailConfig, $thumbNailFormat, $deferred);
+            $thumbnailConfig = $asset->getThumbnail($args['thumbnail'], $deferred)->getConfig();
             if ($thumbnailConfig) {
                 foreach ($thumbnailConfig->getMedias() as $key => $val) {
                     $mediaQueries[] = [