Mixed changes: feature, fixes, and docs from community (#477)

* Mixed changes: feature, fixes, and docs from community

* style: Improve code formatting and consistency in Auth0 and AuthenticationGuard classes

* fix(deps): Update psalm/plugin-laravel to version ^2.12

* fix: Add ignoreFiles section for vendor directory in psalm configuration

Author: kishore7snehil

.github/workflows/semgrep.yml

@@ -249,7 +249,7 @@ A new property has been added to the `config/auth0.php` configuration file: `beh
 
 #### Changes to Guard and Provider driver aliases
 
-We identified an issue with using identical alias naming for both the Guard and Provider singletons under Laravel 10, which has required us to rename these aliases. As previous guidance had been to instantiate these using their class names, this should not be a breaking change in most cases. However, if you had used `auth0` as the name for either the Guard or the Provider drivers, kindly note that these have changed. Please use `auth0.guard` for the Guard driver and `auth0.provider`` for the Provider driver. This is a regrettable change but was necessary for adequate Laravel 10 support.
+We identified an issue with using identical alias naming for both the Guard and Provider singletons under Laravel 10, which has required us to rename these aliases. As previous guidance had been to instantiate these using their class names, this should not be a breaking change in most cases. However, if you had used `auth0` as the name for either the Guard or the Provider drivers, kindly note that these have changed. Please use `auth0.guard` for the Guard driver and `auth0.provider` for the Provider driver. This is a regrettable change but was necessary for adequate Laravel 10 support.
 
 ## [7.4.0](https://github.com/auth0/laravel-auth0/tree/7.4.0) (2022-12-12)
 

CHANGELOG.md

@@ -54,7 +54,7 @@
         "pestphp/pest-plugin-laravel": "^2",
         "phpstan/phpstan": "^1",
         "phpstan/phpstan-strict-rules": "^1",
-        "psalm/plugin-laravel": "^2.10",
+        "psalm/plugin-laravel": "^2.12",
         "psr-mock/http": "^1",
         "rector/rector": "^1",
         "spatie/laravel-ray": "^1.40",

composer.json

@@ -12,6 +12,9 @@
     <projectFiles>
         <directory name="src"/>
         <directory name="deprecated"/>
+        <ignoreFiles>
+            <directory name="vendor"/>
+        </ignoreFiles>
     </projectFiles>
 
     <issueHandlers>

psalm.xml.dist

@@ -9,6 +9,21 @@
 /**
  * Auth0 Laravel SDK service provider. Provides access to the SDK's methods.
  *
+ * @method static \Auth0\SDK\Configuration\SdkConfiguration   getConfiguration()
+ * @method static null|object                                 getCredentials()
+ * @method static null|string                                 getGuardConfigurationKey()
+ * @method static \Auth0\SDK\Contract\Auth0Interface          getSdk()
+ * @method static \Auth0\SDK\Contract\API\ManagementInterface management()
+ * @method static self                                        setGuardConfigurationKey(null|string $guardConfigurationKey = null)
+ * @method static \Auth0\SDK\Contract\Auth0Interface          setSdk(\Auth0\SDK\Contract\Auth0Interface $sdk)
+ * @method static self                                        reset()
+ * @method static self                                        setConfiguration(\Auth0\SDK\Configuration\SdkConfiguration|array|null $configuration = null)
+ *
+ * @see Service
+ * @see ServiceAbstract
+ * @see Entities\InstanceEntityAbstract
+ * @see InstanceEntityTrait
+ *
  * @codeCoverageIgnore
  *
  * @deprecated 7.8.0 Use Auth0\Laravel\Service instead.

src/Auth0.php

@@ -13,6 +13,7 @@
 use Auth0\SDK\Utility\HttpResponse;
 use Illuminate\Auth\Events\{Login, Logout};
 use Illuminate\Contracts\Auth\Authenticatable;
+use Illuminate\Support\Traits\Macroable;
 
 use Throwable;
 
@@ -27,6 +28,8 @@
  */
 final class AuthenticationGuard extends GuardAbstract implements AuthenticationGuardContract
 {
+    use Macroable;
+
     /**
      * @var string
      */

src/Guards/AuthenticationGuard.php

@@ -8,6 +8,7 @@
 use Auth0\Laravel\UserProviderContract;
 use Auth0\SDK\Utility\HttpResponse;
 use Illuminate\Contracts\Auth\Authenticatable;
+use Illuminate\Support\Traits\Macroable;
 
 use function is_array;
 use function is_string;
@@ -19,6 +20,8 @@
  */
 final class AuthorizationGuard extends GuardAbstract implements AuthorizationGuardContract
 {
+    use Macroable;
+
     public function find(): ?CredentialEntityContract
     {
         if ($this->isImpersonating()) {