Add purge on events "GlobalSetSaved" and "GlobalSetDeleted"

Author: eminos

README.md

@@ -75,6 +75,7 @@ Once configured, the addon will automatically purge the Cloudflare cache when co
 - Entry saved/deleted
 - Term saved/deleted
 - Asset saved/deleted
+- Global set saved/deleted (purges everything via `purge_everything_fallback`)
 
 You can configure which events trigger cache purging in the config file.
 
@@ -133,6 +134,8 @@ return [
         'asset_deleted' => true,
         'collection_tree_saved' => true,
         'nav_tree_saved' => true,
+        'global_set_saved' => true,
+        'global_set_deleted' => true,
     ],
 
     // Dispatch purge jobs to the queue instead of running synchronously

config/cloudflare-cache.php

@@ -45,6 +45,8 @@
         'asset_deleted' => true,
         'collection_tree_saved' => true,
         'nav_tree_saved' => true,
+        'global_set_saved' => true,
+        'global_set_deleted' => true,
     ],
 
     'queue_purge' => env('CLOUDFLARE_CACHE_QUEUE_PURGE', false), // Dispatch purge jobs to the queue

src/CloudflareCacheServiceProvider.php

@@ -13,6 +13,8 @@
 use Statamic\Events\AssetDeleted;
 use Statamic\Events\CollectionTreeSaved;
 use Statamic\Events\NavTreeSaved;
+use Statamic\Events\GlobalSetSaved;
+use Statamic\Events\GlobalSetDeleted;
 
 class CloudflareCacheServiceProvider extends AddonServiceProvider
 {
@@ -45,6 +47,12 @@ class CloudflareCacheServiceProvider extends AddonServiceProvider
         NavTreeSaved::class => [
             PurgeCloudflareCache::class,
         ],
+        GlobalSetSaved::class => [
+            PurgeCloudflareCache::class,
+        ],
+        GlobalSetDeleted::class => [
+            PurgeCloudflareCache::class,
+        ],
     ];
 
     /**

src/Listeners/PurgeCloudflareCache.php

@@ -13,6 +13,8 @@
 use Statamic\Events\AssetDeleted;
 use Statamic\Events\CollectionTreeSaved;
 use Statamic\Events\NavTreeSaved;
+use Statamic\Events\GlobalSetSaved;
+use Statamic\Events\GlobalSetDeleted;
 use Statamic\Facades\URL;
 use Illuminate\Support\Facades\Log; // Already present, but good to confirm
 
@@ -113,6 +115,8 @@ protected function shouldHandleEvent(Event $event): bool
             'Statamic\Events\AssetDeleted' => 'asset_deleted',
             'Statamic\Events\CollectionTreeSaved' => 'collection_tree_saved',
             'Statamic\Events\NavTreeSaved' => 'nav_tree_saved',
+            'Statamic\Events\GlobalSetSaved' => 'global_set_saved',
+            'Statamic\Events\GlobalSetDeleted' => 'global_set_deleted',
         ];
 
         $configKey = $eventMap[$eventClass] ?? null;
@@ -173,6 +177,12 @@ protected function getUrlsToPurge(Event $event): array
             // If purge_everything_fallback is disabled, this will do nothing (intended behavior)
         }
 
+        if ($event instanceof GlobalSetSaved || $event instanceof GlobalSetDeleted) {
+            // Global sets can affect many pages (headers, footers, shared blocks, etc.).
+            // We intentionally do not return any URLs here so the listener follows the
+            // existing purge_everything_fallback logic (sync or queued).
+        }
+
         $urls = array_filter($urls);
 
         return array_unique($urls);

tests/Feature/PurgeCacheListenerTest.php

@@ -6,6 +6,8 @@
 use Eminos\StatamicCloudflareCache\Http\Client;
 use Eminos\StatamicCloudflareCache\Listeners\PurgeCloudflareCache;
 use Statamic\Events\EntrySaved;
+use Statamic\Events\GlobalSetSaved;
+use Statamic\Events\GlobalSetDeleted;
 use Statamic\Contracts\Entries\Entry;
 use Statamic\Contracts\Entries\Collection;
 use Illuminate\Support\Facades\Http;
@@ -49,6 +51,11 @@ protected function mockEntry($url = '/test-entry', $collectionUrl = '/test-colle
         return $entry;
     }
 
+    protected function mockGlobals()
+    {
+        return new stdClass();
+    }
+
     #[Test]
     public function it_purges_cache_synchronously_when_entry_is_saved_and_queue_disabled()
     {
@@ -199,4 +206,107 @@ public function it_does_not_dispatch_job_when_queue_enabled_but_no_urls_and_no_f
 
         Queue::assertNothingPushed();
     }
+
+    #[Test]
+    public function it_purges_everything_synchronously_when_global_set_is_saved_and_queue_disabled()
+    {
+        config([
+            'cloudflare-cache.queue_purge' => false,
+            'cloudflare-cache.purge_everything_fallback' => true,
+            'cloudflare-cache.purge_urls' => true,
+            'cloudflare-cache.purge_on.global_set_saved' => true,
+        ]);
+
+        $globals = $this->mockGlobals();
+        $event = new GlobalSetSaved($globals);
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldReceive('purgeEverything')->once();
+        $clientMock->shouldNotReceive('purgeUrls');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+    }
+
+    #[Test]
+    public function it_purges_everything_synchronously_when_global_set_is_deleted_and_queue_disabled()
+    {
+        config([
+            'cloudflare-cache.queue_purge' => false,
+            'cloudflare-cache.purge_everything_fallback' => true,
+            'cloudflare-cache.purge_urls' => true,
+            'cloudflare-cache.purge_on.global_set_deleted' => true,
+        ]);
+
+        $globals = $this->mockGlobals();
+        $event = new GlobalSetDeleted($globals);
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldReceive('purgeEverything')->once();
+        $clientMock->shouldNotReceive('purgeUrls');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+    }
+
+    #[Test]
+    public function it_dispatches_purge_everything_job_when_global_set_is_saved_and_queue_enabled()
+    {
+        config([
+            'cloudflare-cache.queue_purge' => true,
+            'cloudflare-cache.purge_everything_fallback' => true,
+            'cloudflare-cache.purge_urls' => true,
+            'cloudflare-cache.purge_on.global_set_saved' => true,
+        ]);
+
+        $globals = $this->mockGlobals();
+        $event = new GlobalSetSaved($globals);
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldNotReceive('purgeUrls');
+        $clientMock->shouldNotReceive('purgeEverything');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertPushed(PurgeCloudflareCacheJob::class, function ($job) {
+            $reflection = new \ReflectionClass($job);
+            $urlsProp = $reflection->getProperty('urls');
+            $urlsProp->setAccessible(true);
+            $urls = $urlsProp->getValue($job);
+
+            $purgeEverythingProp = $reflection->getProperty('purgeEverything');
+            $purgeEverythingProp->setAccessible(true);
+            $purgeEverything = $purgeEverythingProp->getValue($job);
+
+            return is_null($urls) && $purgeEverything;
+        });
+    }
+
+    #[Test]
+    public function it_does_not_purge_when_global_set_saved_event_is_disabled_in_config()
+    {
+        config([
+            'cloudflare-cache.queue_purge' => false,
+            'cloudflare-cache.purge_everything_fallback' => true,
+            'cloudflare-cache.purge_on.global_set_saved' => false,
+        ]);
+
+        $globals = $this->mockGlobals();
+        $event = new GlobalSetSaved($globals);
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldNotReceive('purgeUrls');
+        $clientMock->shouldNotReceive('purgeEverything');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+        Http::assertNothingSent();
+    }
 }