feat: Configurable Route Paths

config/auth0.php

@@ -55,4 +55,13 @@
             Configuration::CONFIG_TRANSIENT_STORAGE_ID => Configuration::get(Configuration::CONFIG_TRANSIENT_STORAGE_ID),
         ],
     ],
+
+    'routes' => [
+        Configuration::CONFIG_ROUTE_INDEX => Configuration::get(Configuration::CONFIG_ROUTE_INDEX, '/'),
+        Configuration::CONFIG_ROUTE_CALLBACK => Configuration::get(Configuration::CONFIG_ROUTE_CALLBACK, '/callback'),
+        Configuration::CONFIG_ROUTE_LOGIN => Configuration::get(Configuration::CONFIG_ROUTE_LOGIN, '/login'),
+        Configuration::CONFIG_ROUTE_AFTER_LOGIN => Configuration::get(Configuration::CONFIG_ROUTE_AFTER_LOGIN, '/'),
+        Configuration::CONFIG_ROUTE_LOGOUT => Configuration::get(Configuration::CONFIG_ROUTE_LOGOUT, '/logout'),
+        Configuration::CONFIG_ROUTE_AFTER_LOGOUT => Configuration::get(Configuration::CONFIG_ROUTE_AFTER_LOGOUT, '/'),
+    ],
 ];

src/Configuration.php

@@ -148,6 +148,16 @@ final class Configuration implements ConfigurationContract
      */
     public const CONFIG_MANAGEMENT_TOKEN_CACHE = 'managementTokenCache';
 
+    /**
+     * @var string
+     */
+    public const CONFIG_NAMESPACE = 'auth0.';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_NAMESPACE_ROUTES = 'auth0.routes.';
+
     /**
      * @var string
      */
@@ -173,6 +183,41 @@ final class Configuration implements ConfigurationContract
      */
     public const CONFIG_RESPONSE_TYPE = 'responseType';
 
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_AFTER_LOGIN = 'afterLogin';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_AFTER_LOGOUT = 'afterLogout';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_BACKCHANNEL = 'backchannel';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_CALLBACK = 'callback';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_INDEX = 'index';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_LOGIN = 'login';
+
+    /**
+     * @var string
+     */
+    public const CONFIG_ROUTE_LOGOUT = 'logout';
+
     /**
      * @var string
      */
@@ -435,6 +480,17 @@ public static function getPath(): string
         return self::$path;
     }
 
+    public static function string(string $key, ?string $default = null): ?string
+    {
+        $value = config($key, $default);
+
+        if (is_string($value)) {
+            return $value;
+        }
+
+        return null;
+    }
+
     public static function stringOrIntToIntOrNull(
         int | string $value,
         int | null $default = null,

src/Controllers/CallbackControllerAbstract.php

@@ -6,11 +6,11 @@
 
 use Auth0\Laravel\Auth\Guard;
 use Auth0\Laravel\Entities\CredentialEntityContract;
-use Auth0\Laravel\Events;
 use Auth0\Laravel\Events\{AuthenticationFailed, AuthenticationSucceeded};
 use Auth0\Laravel\Exceptions\ControllerException;
 use Auth0\Laravel\Exceptions\Controllers\CallbackControllerException;
 use Auth0\Laravel\Guards\GuardAbstract;
+use Auth0\Laravel\{Configuration, Events};
 use Illuminate\Auth\Events\{Attempting, Authenticated, Failed, Validated};
 use Illuminate\Contracts\Auth\Authenticatable;
 use Illuminate\Http\Request;
@@ -115,7 +115,7 @@ public function __invoke(
         }
 
         if (! $success) {
-            return redirect()->intended('/login');
+            return redirect()->intended(config(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_LOGIN, '/login'));
         }
 
         $credential = ($guard instanceof Guard) ? $guard->find(Guard::SOURCE_SESSION) : $guard->find();
@@ -140,6 +140,6 @@ public function __invoke(
             }
         }
 
-        return redirect()->intended('/');
+        return redirect()->intended(config(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_AFTER_LOGIN, config(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_INDEX, '/')));
     }
 }

src/Controllers/LoginControllerAbstract.php

@@ -6,10 +6,10 @@
 
 use Auth0\Laravel\Auth\Guard;
 use Auth0\Laravel\Entities\CredentialEntityContract;
-use Auth0\Laravel\Events;
 use Auth0\Laravel\Events\LoginAttempting;
 use Auth0\Laravel\Exceptions\ControllerException;
 use Auth0\Laravel\Guards\GuardAbstract;
+use Auth0\Laravel\{Configuration, Events};
 use Illuminate\Http\Request;
 use Symfony\Component\HttpFoundation\Response;
 
@@ -40,7 +40,15 @@ public function __invoke(
         $loggedIn ??= (($guard instanceof Guard) ? $guard->find(Guard::SOURCE_SESSION) : $guard->find()) instanceof CredentialEntityContract;
 
         if ($loggedIn) {
-            return redirect()->intended('/');
+            return redirect()->intended(
+                config(
+                    Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_AFTER_LOGIN,
+                    config(
+                        Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_INDEX,
+                        '/',
+                    ),
+                ),
+            );
         }
 
         session()->regenerate(true);

src/Controllers/LogoutControllerAbstract.php

@@ -5,6 +5,7 @@
 namespace Auth0\Laravel\Controllers;
 
 use Auth0\Laravel\Auth\Guard;
+use Auth0\Laravel\Configuration;
 use Auth0\Laravel\Entities\CredentialEntityContract;
 use Auth0\Laravel\Exceptions\ControllerException;
 use Auth0\Laravel\Guards\GuardAbstract;
@@ -37,16 +38,20 @@ public function __invoke(
         $loggedIn = $guard->check() ? true : null;
         $loggedIn ??= (($guard instanceof Guard) ? $guard->find(Guard::SOURCE_SESSION) : $guard->find()) instanceof CredentialEntityContract;
 
+        $landing = Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_AFTER_LOGOUT);
+        $landing ??= Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_INDEX);
+        $landing ??= '/';
+
         if ($loggedIn) {
             session()->invalidate();
 
             $guard->logout(); /** @phpstan-ignore-line */
-            $route = (string) url('/'); /** @phpstan-ignore-line */
+            $route = (string) url($landing); /** @phpstan-ignore-line */
             $url = $guard->sdk()->authentication()->getLogoutLink($route);
 
             return redirect()->away($url);
         }
 
-        return redirect()->intended('/');
+        return redirect()->intended($landing);
     }
 }

src/ServiceAbstract.php

@@ -55,9 +55,9 @@ final public static function routes(
         string $authenticationGuard = 'auth0-session',
     ): void {
         Route::group(['middleware' => ['web', 'guard:' . $authenticationGuard]], static function (): void {
-            Route::get('/login', LoginController::class)->name('login');
-            Route::get('/logout', LogoutController::class)->name('logout');
-            Route::get('/callback', CallbackController::class)->name('callback');
+            Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_LOGIN) ?? '/login', LoginController::class)->name('login');
+            Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_LOGOUT) ?? '/logout', LogoutController::class)->name('logout');
+            Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_CALLBACK) ?? '/callback', CallbackController::class)->name('callback');
         });
     }
 }

src/ServiceProviderAbstract.php

@@ -220,9 +220,9 @@ final public function registerRoutes(): void
     {
         if (true === config('auth0.registerAuthenticationRoutes')) {
             Route::group(['middleware' => 'web'], static function (): void {
-                Route::get('/login', LoginController::class)->name('login');
-                Route::get('/logout', LogoutController::class)->name('logout');
-                Route::get('/callback', CallbackController::class)->name('callback');
+                Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_LOGIN) ?? '/login', LoginController::class)->name('login');
+                Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_LOGOUT) ?? '/logout', LogoutController::class)->name('logout');
+                Route::get(Configuration::string(Configuration::CONFIG_NAMESPACE_ROUTES . Configuration::CONFIG_ROUTE_CALLBACK) ?? '/callback', CallbackController::class)->name('callback');
             });
         }
     }

tests/Unit/ConfigurationTest.php

@@ -148,3 +148,19 @@
         ->toBeInt()
         ->toEqual(123);
 });
+
+test('string() behaves as expected', function (): void {
+    config(['test2' => [
+        'testInteger' => 123,
+        'testString' => '123',
+    ]]);
+
+    define('AUTH0_OVERRIDE_CONFIGURATION_STRING_METHOD', 'test2');
+
+    expect(Configuration::string('test2.testInteger'))
+        ->toBeNull();
+
+    expect(Configuration::string('test2.testString'))
+        ->toBeString()
+        ->toEqual('123');
+});