From 9831ed6c53868de54ed6766c53833ca643d5472f Mon Sep 17 00:00:00 2001
From: "Fabian @ Blax Software" <fabian@blax.at>
Date: Thu, 23 Apr 2026 19:36:14 +0200
Subject: [PATCH] feat: dispatch FileAccessed and FileNotFound events from
 warehouse

Lets host apps hook project-specific side-effects (access logs, analytics,
tracking pixels) without subclassing WarehouseController.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/Events/FileAccessed.php                  | 22 ++++++++++++++++++++
 src/Events/FileNotFound.php                  | 21 +++++++++++++++++++
 src/Http/Controllers/WarehouseController.php |  5 +++++
 3 files changed, 48 insertions(+)
 create mode 100644 src/Events/FileAccessed.php
 create mode 100644 src/Events/FileNotFound.php

diff --git a/src/Events/FileAccessed.php b/src/Events/FileAccessed.php
new file mode 100644
index 0000000..b76da94
--- /dev/null
+++ b/src/Events/FileAccessed.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace Blax\Files\Events;
+
+use Blax\Files\Models\File;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Http\Request;
+
+/**
+ * Fired by the warehouse controller after a file is resolved and about to be
+ * served. Listen for side-effects that need the resolved File model —
+ * access logs, analytics, tracking pixels, etc.
+ */
+class FileAccessed
+{
+    use Dispatchable;
+
+    public function __construct(
+        public readonly File $file,
+        public readonly Request $request,
+    ) {}
+}
diff --git a/src/Events/FileNotFound.php b/src/Events/FileNotFound.php
new file mode 100644
index 0000000..9c6d717
--- /dev/null
+++ b/src/Events/FileNotFound.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace Blax\Files\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Http\Request;
+
+/**
+ * Fired by the warehouse controller when the requested identifier does not
+ * resolve to a File (persisted or asset-backed). Fires immediately before the
+ * 404 abort, so listeners can record the miss for analytics / tamper alerting.
+ */
+class FileNotFound
+{
+    use Dispatchable;
+
+    public function __construct(
+        public readonly ?string $identifier,
+        public readonly Request $request,
+    ) {}
+}
diff --git a/src/Http/Controllers/WarehouseController.php b/src/Http/Controllers/WarehouseController.php
index 4eec8d2..acb51c2 100644
--- a/src/Http/Controllers/WarehouseController.php
+++ b/src/Http/Controllers/WarehouseController.php
@@ -2,6 +2,8 @@
 
 namespace Blax\Files\Http\Controllers;
 
+use Blax\Files\Events\FileAccessed;
+use Blax\Files\Events\FileNotFound;
 use Blax\Files\Models\File;
 use Blax\Files\Services\WarehouseService;
 use Illuminate\Http\Request;
@@ -16,6 +18,7 @@ class WarehouseController extends Controller
         $file = WarehouseService::searchFile($request, $identifier);
 
         if (! $file) {
+            FileNotFound::dispatch($identifier, $request);
             abort(404);
         }
 
@@ -24,6 +27,8 @@ class WarehouseController extends Controller
             $this->checkAccess($request, $file);
         }
 
+        FileAccessed::dispatch($file, $request);
+
         return $file->respond($request);
     }