auth() helper return type

[rcerljenko]

Laravel Version

12.26.2

PHP Version

8.4.11

Database Driver & Version

No response

Description

I have a custom auth guard which wraps up this library into the laravel auth flow.
It implements the Guard interface (not Stateful, just basic Guard).
Custom guard is registered via extend method in the AuthServiceProvider.

With latest update, auth() is fully return-typed now but for some reason it always expects to return the StatefulGuard which my custom guard is not.

Error message returned when pest-ing the code:

auth(): Return value must be of type Illuminate\Contracts\Auth\Factory|Illuminate\Contracts\Auth\StatefulGuard, App\Services\Auth\PasetoGuard returned

Steps To Reproduce

N/A

[kaynite]

the issue occurs also with sanctum
So using auth('sanctum') like this causes the same issue.

[cbaconnier]

It also fails for when we use the token driver

    'guards' => [
        'api' => [
            'driver'   => 'token',
            'provider' => 'users',
        ],
    ],

auth('api')->user();

TypeError: auth(): Return value must be of type Illuminate\Contracts\Auth\Factory|Illuminate\Contracts\Auth\StatefulGuard, Illuminate\Auth\TokenGuard

[grvoyt]

problem here

function auth($guard = null): AuthFactory|StatefulGuard

[Saifallak]

solved by locking laravel to version 12.25 instead of 12.26

[mihob]

Same issue here!

[AndreySavenkov]

Seems like 12.26.3 fixed this issue

[vaggelis-net]

Seems like 12.26.3 fixed this issue

Can confirm

[crynobone]

Fixed in 12.26.3