Expand Configuration Properties (and Refactor Config Builder)

[evansims]

Changes

This PR refactors the configuration building step, which is responsible for reshaping the Laravel configuration array into a format consumable by the underlying PHP SDK.

This PR also includes new configuration options for the tokenCache, managementTokenCache, sessionStorage, and transientStorage properties.

These now accept a false boolean value to disable those features:

<?php // config/auth0.php

declare(strict_types=1);

use Auth0\Laravel\Configuration;
use Auth0\SDK\Configuration\SdkConfiguration;

return [
    // Disables sessions (still defaults to SDK's `LaravelSessionStore`)
    'sessionStorage' => false
];

These properties also now accept string values, either a class name (\Some\Cache::class) or alias (cache.psr6) for the SDK to instantiate a given class at runtime:

<?php // config/auth0.php

declare(strict_types=1);

use Auth0\Laravel\Configuration;
use Auth0\SDK\Configuration\SdkConfiguration;

return [
    // Use Laravels built-in PSR6 interface for caching (still defaults to SDK's `LaravelCachePool`)
    'managementTokenCache' => 'cache.psr6'
];

These changes are not breaking as these properties were previously hard-coded and assigned by the SDK at configuration build time.

References

Resolves #380

Testing

Contributor Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 code of conduct

[codecov]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (6f23b16) 100.00% compared to head (c5f93d7) 100.00%.

Additional details and impacted files

@@             Coverage Diff             @@
##                main      #381   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
  Complexity       295       295           
===========================================
  Files             21        21           
  Lines            806       806           
===========================================
  Hits             806       806           

Flag	Coverage Δ
unittests	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
src/Auth0.php	100.00% <100.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[poovamraj]

👍