added event cache check and tweaked middleware event

Author: n0nag0n

flight/Engine.php

@@ -486,7 +486,7 @@ protected function processMiddleware(Route $route, string $eventName): bool
             // Which loosely translates to $class->$method($params)
             $start = microtime(true);
             $middlewareResult = $middlewareObject($params);
-            $this->triggerEvent('flight.middleware.executed', $route, $middleware, microtime(true) - $start);
+            $this->triggerEvent('flight.middleware.executed', $route, $middleware, $eventName, microtime(true) - $start);
 
             if ($useV3OutputBuffering === true) {
                 $this->response()->write(ob_get_clean());
@@ -1002,10 +1002,10 @@ public function _etag(string $id, string $type = 'strong'): void
 
         $this->response()->header('ETag', '"' . str_replace('"', '\"', $id) . '"');
 
-        if (
-            isset($_SERVER['HTTP_IF_NONE_MATCH']) &&
-            $_SERVER['HTTP_IF_NONE_MATCH'] === $id
-        ) {
+        $hit = isset($_SERVER['HTTP_IF_NONE_MATCH']) && $_SERVER['HTTP_IF_NONE_MATCH'] === $id;
+        $this->triggerEvent('flight.cache.checked', 'etag', $hit, 0.0);
+
+        if ($hit === true) {
             $this->response()->clear();
             $this->halt(304, '', empty(getenv('PHPUNIT_TEST')));
         }
@@ -1020,10 +1020,10 @@ public function _lastModified(int $time): void
     {
         $this->response()->header('Last-Modified', gmdate('D, d M Y H:i:s \G\M\T', $time));
 
-        if (
-            isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) &&
-            strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) === $time
-        ) {
+        $hit = isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) && strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) === $time;
+        $this->triggerEvent('flight.cache.checked', 'lastModified', $hit, 0.0);
+
+        if ($hit === true) {
             $this->response()->clear();
             $this->halt(304, '', empty(getenv('PHPUNIT_TEST')));
         }

flight/core/EventDispatcher.php

@@ -44,9 +44,12 @@ public function on(string $event, callable $callback): void
      *
      * @param string $event Event name
      * @param mixed ...$args Arguments to pass to the callbacks
+     *
+     * @return mixed
      */
-    public function trigger(string $event, ...$args): void
+    public function trigger(string $event, ...$args)
     {
+        $result = null;
         if (isset($this->listeners[$event]) === true) {
             foreach ($this->listeners[$event] as $callback) {
                 $result = call_user_func_array($callback, $args);
@@ -57,6 +60,7 @@ public function trigger(string $event, ...$args): void
                 }
             }
         }
+        return $result;
     }
 
     /**