Add markers for Cached Components

config/permanent-cache.php

@@ -0,0 +1,15 @@
+<?php
+
+return [
+    'components' => [
+        // Add markers around the rendered value of Cached Components,
+        // this helps to identify the cached value in the rendered HTML.
+
+        // Which is useful for debugging and testing, but also for updating
+        // the cached value inside another cache when using nested caches
+        'markers' => [
+            'enabled' => env('PERMANENT_CACHE_MARKERS_ENABLED', false),
+            'hash' => env('PERMANENT_CACHE_MARKERS_HASH', false),
+        ],
+    ],
+];

src/CachedComponent.php

@@ -19,11 +19,35 @@
             $this->isUpdating ||
             $this->shouldBeUpdating()
         ) {
-            return parent::resolveView();
+            return $this->renderOutput(
+                parent::resolveView()
+            );
         }
 
         if (null !== $cachedValue = $this->get($this->getParameters())) {
-            return new HtmlString((string) $cachedValue);
+            return new HtmlString($this->renderOutput((string) $cachedValue));
         }
     }
+
+    public function getMarker(): string
+    {
+        [$cacheDriver, $cacheKey] = $this::store($this->getParameters());
+
+        $marker = $cacheDriver.':'.$cacheKey;
+
+        if (config('permanent-cache.components.markers.hash')) {
+            $marker = md5($marker);
+        }
+
+        return '<!--##########'.$marker.'##########-->';
+    }
+
+    public function renderOutput($value): HtmlString
+    {
+        if (config('permanent-cache.components.markers.enabled')) {
+            $value = $this->getMarker().$value.$this->getMarker();
+        }
+
+        return new HtmlString($value);
+    }
 }

src/CachesValue.php

@@ -74,7 +74,7 @@ final public function handle($event = null): void
         PermanentCacheUpdating::dispatch($this);
 
         $value = is_subclass_of(static::class, CachedComponent::class)
-            ? Blade::renderComponent($this)
+            ? (string) Blade::renderComponent($this)
             : $this->run($event);
 
         if (is_null($value)) {
@@ -94,7 +94,7 @@ public function getParameters()
             ->getProperties(\ReflectionProperty::IS_PUBLIC))
             ->filter(fn (\ReflectionProperty $p) => $p->class === static::class)
             ->mapWithKeys(fn (\ReflectionProperty $p) => [$p->name => $p->getValue($this)])
-            ->toArray();
+            ->all();
     }
 
     /**
@@ -152,8 +152,11 @@ final public static function get($default = null, bool $update = false): mixed
 
         $cache = Cache::driver($driver);
 
-        if ($update && ! $cache->has($cacheKey)) {
-            static::update($parameters ?? [])->onConnection('sync');
+        if (
+            $update ||
+            ! $cache->has($cacheKey)
+        ) {
+            static::update($parameters ?? [])?->onConnection('sync');
         }
 
         return $cache->get($cacheKey, $default);

src/PermanentCacheServiceProvider.php

@@ -10,7 +10,8 @@ class PermanentCacheServiceProvider extends PackageServiceProvider
 {
     public function configurePackage(Package $package): void
     {
-        $package->name('laravel-permanent-cache');
+        $package->name('laravel-permanent-cache')
+            ->hasConfigFile();
     }
 
     public function registeringPackage()