Add optional Statamic static-cache invalidation integration for targeted Cloudflare purges

README.md

@@ -7,6 +7,7 @@ Automatically purge your Cloudflare cache when content changes in Statamic.
 - Automatically purges Cloudflare cache when Statamic content changes.
 - **Multi-zone support** for Statamic multisite installations with different domains.
 - Configurable events that trigger cache purging.
+- Optional support for Statamic `static_caching` invalidation rules via `UrlInvalidated`/`StaticCacheCleared` events.
 - Optional queuing of purge jobs for background processing.
 - CLI command for manual cache purging.
 - Simple configuration with backward compatibility.
@@ -136,8 +137,13 @@ return [
         'nav_tree_saved' => true,
         'global_set_saved' => true,
         'global_set_deleted' => true,
+        'url_invalidated' => true,
+        'static_cache_cleared' => true,
     ],
 
+    // Use Statamic static cache invalidation events instead of direct content events
+    'use_statamic_static_cache_invalidation' => env('CLOUDFLARE_CACHE_USE_STATAMIC_STATIC_CACHE_INVALIDATION', false),
+
     // Dispatch purge jobs to the queue instead of running synchronously
     'queue_purge' => env('CLOUDFLARE_CACHE_QUEUE_PURGE', false),
 

config/cloudflare-cache.php

@@ -47,8 +47,12 @@
         'nav_tree_saved' => true,
         'global_set_saved' => true,
         'global_set_deleted' => true,
+        'url_invalidated' => true,
+        'static_cache_cleared' => true,
     ],
 
+    'use_statamic_static_cache_invalidation' => env('CLOUDFLARE_CACHE_USE_STATAMIC_STATIC_CACHE_INVALIDATION', false),
+
     'queue_purge' => env('CLOUDFLARE_CACHE_QUEUE_PURGE', false), // Dispatch purge jobs to the queue
 
     /*

src/CloudflareCacheServiceProvider.php

@@ -15,6 +15,8 @@
 use Statamic\Events\NavTreeSaved;
 use Statamic\Events\GlobalSetSaved;
 use Statamic\Events\GlobalSetDeleted;
+use Statamic\Events\UrlInvalidated;
+use Statamic\Events\StaticCacheCleared;
 
 class CloudflareCacheServiceProvider extends AddonServiceProvider
 {
@@ -53,6 +55,12 @@ class CloudflareCacheServiceProvider extends AddonServiceProvider
         GlobalSetDeleted::class => [
             PurgeCloudflareCache::class,
         ],
+        UrlInvalidated::class => [
+            PurgeCloudflareCache::class,
+        ],
+        StaticCacheCleared::class => [
+            PurgeCloudflareCache::class,
+        ],
     ];
 
     /**

src/Listeners/PurgeCloudflareCache.php

@@ -16,6 +16,8 @@
 use Statamic\Events\NavTreeSaved;
 use Statamic\Events\GlobalSetSaved;
 use Statamic\Events\GlobalSetDeleted;
+use Statamic\Events\UrlInvalidated;
+use Statamic\Events\StaticCacheCleared;
 use Statamic\Facades\URL;
 use Illuminate\Support\Facades\Log; // Already present, but good to confirm
 
@@ -108,6 +110,17 @@ protected function purgeSynchronously(array $urls): void
      */
     protected function shouldHandleEvent(Event $event): bool
     {
+        $useStatamicInvalidation = config('cloudflare-cache.use_statamic_static_cache_invalidation', false);
+        $isStaticCacheInvalidationEvent = $event instanceof UrlInvalidated || $event instanceof StaticCacheCleared;
+
+        if ($useStatamicInvalidation && !$isStaticCacheInvalidationEvent) {
+            return false;
+        }
+
+        if (!$useStatamicInvalidation && $isStaticCacheInvalidationEvent) {
+            return false;
+        }
+
         $eventClass = get_class($event);
         $eventMap = [
             'Statamic\Events\EntrySaved' => 'entry_saved',
@@ -120,6 +133,8 @@ protected function shouldHandleEvent(Event $event): bool
             'Statamic\Events\NavTreeSaved' => 'nav_tree_saved',
             'Statamic\Events\GlobalSetSaved' => 'global_set_saved',
             'Statamic\Events\GlobalSetDeleted' => 'global_set_deleted',
+            'Statamic\Events\UrlInvalidated' => 'url_invalidated',
+            'Statamic\Events\StaticCacheCleared' => 'static_cache_cleared',
         ];
 
         $configKey = $eventMap[$eventClass] ?? null;
@@ -186,6 +201,10 @@ protected function getUrlsToPurge(Event $event): array
             // existing purge_everything_fallback logic (sync or queued).
         }
 
+        if ($event instanceof UrlInvalidated && $event->url) {
+            $urls[] = URL::makeAbsolute($event->url);
+        }
+
         $urls = array_filter($urls);
 
         return array_unique($urls);

tests/Feature/PurgeCacheListenerTest.php

@@ -8,6 +8,8 @@
 use Statamic\Events\EntrySaved;
 use Statamic\Events\GlobalSetSaved;
 use Statamic\Events\GlobalSetDeleted;
+use Statamic\Events\UrlInvalidated;
+use Statamic\Events\StaticCacheCleared;
 use Statamic\Contracts\Entries\Entry;
 use Statamic\Contracts\Entries\Collection;
 use Illuminate\Support\Facades\Event;
@@ -355,4 +357,93 @@ public function it_fires_cache_purged_event_after_synchronous_purge_everything()
             return $e->purgedEverything && empty($e->urls);
         });
     }
+
+    #[Test]
+    public function it_ignores_legacy_events_when_statamic_static_cache_invalidation_is_enabled()
+    {
+        Event::fake([CachePurged::class]);
+        config([
+            'cloudflare-cache.use_statamic_static_cache_invalidation' => true,
+            'cloudflare-cache.queue_purge' => false,
+        ]);
+
+        $entry = $this->mockEntry();
+        $event = new EntrySaved($entry);
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldNotReceive('purgeUrls');
+        $clientMock->shouldNotReceive('purgeEverything');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+        Event::assertNotDispatched(CachePurged::class);
+    }
+
+    #[Test]
+    public function it_purges_invalidated_urls_when_statamic_static_cache_invalidation_is_enabled()
+    {
+        Event::fake([CachePurged::class]);
+        config([
+            'cloudflare-cache.use_statamic_static_cache_invalidation' => true,
+            'cloudflare-cache.queue_purge' => false,
+        ]);
+
+        $event = new UrlInvalidated('/test-entry', 'https://example.com');
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldReceive('purgeUrls')->once()->with(['https://example.com/test-entry']);
+        $clientMock->shouldNotReceive('purgeEverything');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+        Event::assertDispatched(CachePurged::class, function ($e) {
+            return !$e->purgedEverything && $e->urls === ['https://example.com/test-entry'];
+        });
+    }
+
+    #[Test]
+    public function it_purges_everything_when_static_cache_is_cleared_and_statamic_static_cache_invalidation_is_enabled()
+    {
+        config([
+            'cloudflare-cache.use_statamic_static_cache_invalidation' => true,
+            'cloudflare-cache.queue_purge' => false,
+            'cloudflare-cache.purge_everything_fallback' => true,
+        ]);
+
+        $event = new StaticCacheCleared();
+
+        $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_does_not_purge_when_static_cache_is_cleared_and_fallback_is_disabled()
+    {
+        config([
+            'cloudflare-cache.use_statamic_static_cache_invalidation' => true,
+            'cloudflare-cache.queue_purge' => false,
+            'cloudflare-cache.purge_everything_fallback' => false,
+        ]);
+
+        $event = new StaticCacheCleared();
+
+        $clientMock = $this->mock(Client::class);
+        $clientMock->shouldNotReceive('purgeEverything');
+        $clientMock->shouldNotReceive('purgeUrls');
+
+        $listener = $this->app->make(PurgeCloudflareCache::class);
+        $listener->handle($event);
+
+        Queue::assertNothingPushed();
+    }
 }