Allow global resolver Middlewares

CHANGELOG.md

@@ -1,8 +1,13 @@
 CHANGELOG
 =========
 
-[Next release](https://github.com/rebing/graphql-laravel/compare/9.3.0...master)
---------------
+[Next release](https://github.com/rebing/graphql-laravel/compare/9.4.0...master)
+
+2024-02-27, 9.4.0
+-----------------
+
+## Added
+- Possibility to add resolver middleware at runtime using `GraphQL::appendGlobalResolverMiddleware(YourMiddleware::class)`
 
 2024-02-18, 9.3.0
 -----------------

README.md

@@ -1150,6 +1150,16 @@ Alternatively, you can override `getMiddleware` to supply your own logic:
         return array_merge([...], $this->middleware);
     }
 ```
+If you want to register middleware globally, use can use the `appendGlobalResolverMiddleware` method in ServiceProvider:
+
+```php
+    ...
+    public function boot()
+    {
+        ...
+        GraphQL::appendGlobalResolverMiddleware(YourMiddleware::class);
+    }
+```
 
 #### Terminable middleware
 

src/GraphQL.php

@@ -51,6 +51,13 @@ class GraphQL
      */
     protected $types = [];
 
+    /**
+     * These middleware are executed before all resolve methods
+     *
+     * @var array<object|class-string>
+     */
+    protected $globalResolverMiddlewares = [];
+
     /** @var Type[] */
     protected $typesInstances = [];
 
@@ -186,6 +193,22 @@ protected function appendGraphqlExecutionMiddleware(array $middlewares): array
         return $middlewares;
     }
 
+    /**
+     * @phpstan-param class-string|object $class
+     */
+    public function appendGlobalResolverMiddleware(object|string $class): void
+    {
+        $this->globalResolverMiddlewares[] = $class;
+    }
+
+    /**
+     * @phpstan-return array<object|class-string>
+     */
+    public function getGlobalResolverMiddlewares(): array
+    {
+        return $this->globalResolverMiddlewares;
+    }
+
     /**
      * @param array<int|string,string> $types
      */

src/Support/Facades/GraphQL.php

@@ -24,6 +24,8 @@
  * @method static Schema buildSchemaFromConfig(array $schemaConfig)
  * @method static array getSchemas()
  * @method static void addSchema(string $name, Schema $schema)
+ * @method static array getGlobalResolverMiddlewares()
+ * @method static void appendGlobalResolverMiddleware(object|string $class)
  * @method static void addType(object|string $class, string $name = null)
  * @method static Type objectType(ObjectType|array|string $type, array $opts = [])
  * @method static array formatError(Error $e)

src/Support/Field.php

@@ -13,6 +13,7 @@
 use Rebing\GraphQL\Error\AuthorizationError;
 use Rebing\GraphQL\Error\ValidationError;
 use Rebing\GraphQL\Support\AliasArguments\AliasArguments;
+use Rebing\GraphQL\Support\Facades\GraphQL;
 use ReflectionMethod;
 
 /**
@@ -145,6 +146,15 @@ protected function getMiddleware(): array
         return $this->middleware;
     }
 
+    /**
+     * @return array<class-string|object>
+     * @phpstan-param array<string> $middleware
+     */
+    protected function appendGlobalMiddlewares(array $middleware): array
+    {
+        return array_merge($middleware, GraphQL::getGlobalResolverMiddlewares());
+    }
+
     protected function getResolver(): ?Closure
     {
         $resolver = $this->originalResolver();
@@ -154,7 +164,7 @@ protected function getResolver(): ?Closure
         }
 
         return function ($root, ...$arguments) use ($resolver) {
-            $middleware = $this->getMiddleware();
+            $middleware = $this->appendGlobalMiddlewares($this->getMiddleware());
 
             return app()->make(Pipeline::class)
                 ->send(array_merge([$this], $arguments))
@@ -165,7 +175,7 @@ protected function getResolver(): ?Closure
 
                     foreach ($middleware as $name) {
                         /** @var Middleware $instance */
-                        $instance = app()->make($name);
+                        $instance = \is_object($name) ? $name : app()->make($name);
 
                         if (method_exists($instance, 'terminate')) {
                             app()->terminating(function () use ($arguments, $instance, $result): void {

tests/Support/Middlewares/GlobalMiddleware.php

@@ -0,0 +1,19 @@
+<?php declare(strict_types = 1);
+namespace Rebing\GraphQL\Tests\Support\Middlewares;
+
+use Closure;
+use GraphQL\Type\Definition\ResolveInfo;
+use Rebing\GraphQL\Support\Middleware;
+
+class GlobalMiddleware extends Middleware
+{
+    /**
+     * @phpstan-param mixed $root
+     * @phpstan-param mixed $context
+     * @phpstan-return mixed
+     */
+    public function handle($root, array $args, $context, ResolveInfo $info, Closure $next): mixed
+    {
+        return parent::handle($root, $args, $context, $info, $next);
+    }
+}

tests/Unit/MiddlewareTest.php

@@ -4,6 +4,7 @@
 namespace Rebing\GraphQL\Tests\Unit;
 
 use Rebing\GraphQL\Support\Facades\GraphQL;
+use Rebing\GraphQL\Tests\Support\Middlewares\GlobalMiddleware;
 use Rebing\GraphQL\Tests\TestCase;
 
 class MiddlewareTest extends TestCase
@@ -79,4 +80,17 @@ public function testMiddlewareTerminateHappensAfterResponseIsSent(): void
         self::assertObjectHasProperty('errors', $result);
         self::assertMatchesRegularExpression('/^Undefined .* 6$/', $result->errors[0]->getMessage());
     }
+
+    public function testGlobalMiddlewareExecuted(): void
+    {
+        $mock = $this->partialMock(GlobalMiddleware::class);
+        GraphQL::appendGlobalResolverMiddleware($mock);
+        $result = GraphQL::queryAndReturnResult($this->queries['exampleMiddleware'], [
+            'index' => 2,
+        ]);
+        $mock->shouldHaveReceived('handle');
+
+        self::assertObjectHasProperty('errors', $result);
+        self::assertSame('Example 3 is not allowed', $result->errors[0]->getMessage());
+    }
 }