feat: add version option and test

Author: ace-of-aces

config/image-transform-url.php

@@ -42,6 +42,7 @@
         'quality',
         'flip',
         'contrast',
+        'version',
         // 'blur'
     ]),
 

src/Enums/AllowedOptions.php

@@ -13,6 +13,7 @@ enum AllowedOptions: string
     case Blur = 'blur';
     case Contrast = 'contrast';
     case Flip = 'flip';
+    case Version = 'version';
 
     public static function all(): array
     {
@@ -29,6 +30,7 @@ public static function withTypes(): array
             self::Blur->value => 'integer',
             self::Contrast->value => 'integer',
             self::Flip->value => 'string',
+            self::Version->value => 'integer',
         ];
     }
 }

tests/Feature/CacheTest.php

@@ -27,3 +27,31 @@
     $response->assertOk();
     $secondResponse->assertHeader('X-Cache', 'HIT');
 });
+
+it('can use the version option to revalidate the cache', function () {
+    /** @var TestCase $this */
+
+    $response = $this->get(route('image.transform', [
+        'options' => 'version=1',
+        'path' => 'cat.jpg',
+    ]));
+
+    $response->assertOk();
+    $response->assertHeader('X-Cache', 'MISS');
+
+    $sameVersionResponse = $this->get(route('image.transform', [
+        'options' => 'version=1',
+        'path' => 'cat.jpg',
+    ]));
+
+    $sameVersionResponse->assertOk();
+    $sameVersionResponse->assertHeader('X-Cache', 'HIT');
+
+    $differentVersionResponse = $this->get(route('image.transform', [
+        'options' => 'version=2',
+        'path' => 'cat.jpg',
+    ]));
+
+    $differentVersionResponse->assertOk();
+    $differentVersionResponse->assertHeader('X-Cache', 'MISS');
+});