add tests

Author: bst27

README.md

@@ -110,3 +110,16 @@ php artisan vendor:publish --provider="Bst27\ImageProxy\ImageProxyServiceProvide
 This will create `config/image-proxy.php`.
 
 ---
+
+## Tests
+
+To run tests, you can execute the following command:
+
+```bash
+docker run --rm -it \
+  -u "$(id -u):$(id -g)" \
+  -v "$PWD":/var/www/html \
+  -w /var/www/html \
+  laravelsail/php84-composer:latest \
+  php vendor/bin/phpunit
+```

composer.json

@@ -31,7 +31,8 @@
         "psr-4": {
             "Workbench\\App\\": "workbench/app/",
             "Workbench\\Database\\Factories\\": "workbench/database/factories/",
-            "Workbench\\Database\\Seeders\\": "workbench/database/seeders/"
+            "Workbench\\Database\\Seeders\\": "workbench/database/seeders/",
+            "Bst27\\ImageProxy\\Tests\\": "tests/"
         }
     },
     "scripts": {

phpunit.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php"
+         colors="true"
+         stopOnFailure="false">
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>./tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Feature">
+            <directory>./tests/Feature</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

tests/Feature/ImageProxyControllerTest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Bst27\ImageProxy\Tests\Feature;
+
+use Bst27\ImageProxy\Tests\TestCase;
+
+class ImageProxyControllerTest extends TestCase
+{
+    public function testServeFilenameRejectsWrongFilename()
+    {
+        $good = proxy_image('images/60x40.png', 'default', 'bar.png', []);
+        $bad = preg_replace('/bar\.png$/', 'baz.png', $good);
+
+        $this->get($bad)->assertStatus(404);
+        $this->get($good)->assertStatus(200);
+    }
+
+    public function testServeShortRejectsWrongExtension()
+    {
+        $good = proxy_image('images/60x40.png');
+        $bad = preg_replace('/\.png$/', '.dat', $good);
+
+        $this->get($bad)->assertStatus(404);
+        $this->get($good)->assertStatus(200);
+    }
+
+    public function testInvalidTokenReturns404()
+    {
+        $this->get('/img/invalid-token-123.png')->assertStatus(404);
+    }
+}

tests/Feature/ProxyImageHelperTest.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Bst27\ImageProxy\Tests\Feature;
+
+use Bst27\ImageProxy\Tests\TestCase;
+
+class ProxyImageHelperTest extends TestCase
+{
+    public function testHelperAndDefaultManipulatorIntegration()
+    {
+        $url = proxy_image('images/60x40.jpg', 'default', false, []);
+
+        $response = $this->get($url);
+
+        $response->assertStatus(200);
+        $response->assertHeader('Content-Type', 'image/jpeg');
+        $this->assertNotEmpty($response->streamedContent());
+    }
+}

tests/Fixtures/images/60x40.jpg

@@ -0,0 +1,26 @@
+<?php
+
+namespace Bst27\ImageProxy\Tests;
+
+use Bst27\ImageProxy\ImageProxyServiceProvider;
+use Orchestra\Testbench\TestCase as OrchestraTestCase;
+
+abstract class TestCase extends OrchestraTestCase
+{
+    protected function getPackageProviders($app): array
+    {
+        return [
+            ImageProxyServiceProvider::class,
+        ];
+    }
+
+    protected function getEnvironmentSetUp($app): void
+    {
+        // Use local disk for source images, pointing at tests/Fixtures
+        $app['config']->set('image-proxy.disks.source', 'fixtures');
+        $app['config']->set('filesystems.disks.fixtures', [
+            'driver' => 'local',
+            'root'   => __DIR__ . '/Fixtures',
+        ]);
+    }
+}

tests/Fixtures/images/60x40.png

@@ -0,0 +1,22 @@
+<?php
+
+namespace Bst27\ImageProxy\Tests\Unit;
+
+use Bst27\ImageProxy\Services\Base64UrlTokenEncoder;
+use Bst27\ImageProxy\Tests\TestCase;
+
+class Base64UrlTokenEncoderTest extends TestCase
+{
+    public function testEncodeDecodeRoundtrip()
+    {
+        $encoder = new Base64UrlTokenEncoder();
+        $plain   = 'hello-world-123';
+        $encoded = $encoder->encode($plain);
+
+        $this->assertNotEmpty($encoded);
+        $this->assertNotSame($plain, $encoded);
+
+        $decoded = $encoder->decode($encoded);
+        $this->assertSame($plain, $decoded);
+    }
+}

tests/TestCase.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Bst27\ImageProxy\Tests\Unit;
+
+use Bst27\ImageProxy\Services\ImageManipulator\DefaultManipulator;
+use Bst27\ImageProxy\Tests\TestCase;
+use Illuminate\Support\Facades\Storage;
+
+class DefaultManipulatorTest extends TestCase
+{
+    public function testManipulateReturnsCompressedPng()
+    {
+        $binary = Storage::disk('fixtures')->get('images/60x40.png');
+
+        $manipulator = new DefaultManipulator();
+        $result      = $manipulator->manipulate($binary, []);
+
+        $this->assertIsString($result);
+        $this->assertNotEmpty($result);
+        $this->assertStringStartsWith("\x89PNG", $result);
+    }
+}