fix: base class guard in return types is breaking custom guards (#56779)

phadaphunk · web-flow · commit aef19cd74d2e · 2025-08-27T08:39:43.000-05:00
* fix: base class guard in return types

* review: remove unused guard

* fix: failing type check
diff --git a/src/Illuminate/Foundation/helpers.php b/src/Illuminate/Foundation/helpers.php
@@ -6,7 +6,7 @@
 use Illuminate\Container\Container;
 use Illuminate\Contracts\Auth\Access\Gate;
 use Illuminate\Contracts\Auth\Factory as AuthFactory;
-use Illuminate\Contracts\Auth\StatefulGuard;
+use Illuminate\Contracts\Auth\Guard;
 use Illuminate\Contracts\Broadcasting\Factory as BroadcastFactory;
 use Illuminate\Contracts\Bus\Dispatcher;
 use Illuminate\Contracts\Cookie\Factory as CookieFactory;
@@ -169,9 +169,9 @@ function asset($path, $secure = null): string
      * Get the available auth instance.
      *
      * @param  string|null  $guard
-     * @return ($guard is null ? \Illuminate\Contracts\Auth\Factory : \Illuminate\Contracts\Auth\StatefulGuard)
+     * @return ($guard is null ? \Illuminate\Contracts\Auth\Factory : \Illuminate\Contracts\Auth\Guard)
      */
-    function auth($guard = null): AuthFactory|StatefulGuard
+    function auth($guard = null): AuthFactory|Guard
     {
         if (is_null($guard)) {
             return app(AuthFactory::class);
diff --git a/types/Foundation/Helpers.php b/types/Foundation/Helpers.php
@@ -9,7 +9,7 @@
 assertType('Illuminate\Config\Repository', app(Repository::class));
 
 assertType('Illuminate\Contracts\Auth\Factory', auth());
-assertType('Illuminate\Contracts\Auth\StatefulGuard', auth('foo'));
+assertType('Illuminate\Contracts\Auth\Guard', auth('foo'));
 
 assertType('Illuminate\Cache\CacheManager', cache());
 assertType('bool', cache(['foo' => 'bar'], 42));
