add guard transformer

src/ValueObjects/Values/GuardTransformer.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EriBloo\CacheObjects\ValueObjects\Values;
+
+use EriBloo\CacheObjects\Contracts\CacheValueTransformer;
+use Closure;
+
+/**
+ * @template TValue
+ *
+ * @implements CacheValueTransformer<TValue>
+ */
+final readonly class GuardTransformer implements CacheValueTransformer
+{
+    /**
+     * @param CacheValueTransformer<TValue> $transformer
+     * @param (Closure(TValue): void)|null $onSaveGuard
+     * @param (Closure(TValue): void)|null $onLoadGuard
+     */
+    public function __construct(
+        private CacheValueTransformer $transformer,
+        private Closure|null $onSaveGuard = null,
+        private Closure|null $onLoadGuard = null,
+    ) {}
+
+    public function onLoad(string $value): mixed
+    {
+        $transformed = $this->transformer->onLoad($value);
+
+        if ($this->onLoadGuard !== null) {
+            call_user_func($this->onLoadGuard, $transformed);
+        }
+
+        return $transformed;
+    }
+
+    public function onSave(mixed $value): string
+    {
+        if ($this->onSaveGuard !== null) {
+            call_user_func($this->onSaveGuard, $value);
+        }
+
+        return $this->transformer->onSave($value);
+    }
+}

tests/CacheObjectTest.php

@@ -4,7 +4,9 @@
 
 use EriBloo\CacheObjects\Tests\Fixtures\BasicCacheObject;
 use EriBloo\CacheObjects\Tests\Fixtures\EncryptedCacheObject;
+use EriBloo\CacheObjects\Tests\Fixtures\GuardCacheObject;
 use EriBloo\CacheObjects\Tests\Fixtures\HashedCacheObject;
+use EriBloo\CacheObjects\Tests\Fixtures\ObjectWithTime;
 
 use function PHPUnit\Framework\assertEquals;
 use function PHPUnit\Framework\assertNotNull;
@@ -57,3 +59,28 @@
     assertEquals(serialize('test'), Crypt::decryptString(app('store')->get((string) $obj->key())));
     assertEquals('test', $obj->retrieve());
 });
+
+it('guards on save properly', function () {
+    // prepare
+    $obj = new GuardCacheObject(function (ObjectWithTime $value) {
+        if ($value->time->isFuture()) {
+            throw new InvalidArgumentException();
+        }
+    }, null);
+
+    // execute and assert
+    $obj->store(new ObjectWithTime(now()->addHour()));
+})->throws(InvalidArgumentException::class);
+
+it('guards on load properly', function () {
+    // prepare
+    $obj = new GuardCacheObject(null, function ($value) {
+        if ($value->time->isFuture()) {
+            throw new InvalidArgumentException();
+        }
+    });
+    $obj->store(value: new ObjectWithTime(now()->addHour()));
+
+    // execute and assert
+    $obj->retrieve();
+})->throws(InvalidArgumentException::class);

tests/Fixtures/GuardCacheObject.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EriBloo\CacheObjects\Tests\Fixtures;
+
+use Carbon\CarbonInterval;
+use EriBloo\CacheObjects\Concerns\CacheObjectActions;
+use EriBloo\CacheObjects\Contracts\CacheObject;
+use EriBloo\CacheObjects\ValueObjects\Keys\StringKey;
+use EriBloo\CacheObjects\ValueObjects\Values\GuardTransformer;
+use EriBloo\CacheObjects\ValueObjects\Values\SerializeTransformer;
+use Closure;
+
+/**
+ * @template ObjectWithTime
+ *
+ * @implements CacheObject<ObjectWithTime>
+ */
+final class GuardCacheObject implements CacheObject
+{
+    use CacheObjectActions;
+
+    public function __construct(
+        private Closure|null $onSaveGuard,
+        private Closure|null $onLoadGuard,
+    ) {}
+
+    public function key(): StringKey
+    {
+        return new StringKey('guard-cache-object');
+    }
+
+    public function ttl(): CarbonInterval
+    {
+        return CarbonInterval::seconds(0);
+    }
+
+    /**
+     * @return GuardTransformer<ObjectWithTime>
+     */
+    public function transformer(): GuardTransformer
+    {
+        return new GuardTransformer(new SerializeTransformer(), $this->onSaveGuard, $this->onLoadGuard);
+    }
+}

tests/Fixtures/ObjectWithTime.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EriBloo\CacheObjects\Tests\Fixtures;
+
+use Carbon\CarbonInterface;
+
+final readonly class ObjectWithTime
+{
+    public function __construct(
+        public CarbonInterface $time,
+    ) {}
+}