Refactor connectAccountWithRedirect to Use Top-Level Scopes and Upgrade Auth0 SPA JS to v2.9.0 (#933)

## 📝 Pull Request Description

Completes this PR - #930

### 🔄 Changes
- Updated Auth0 SPA JS dependency from version 2.7.0 to 2.9.0.
- Refactored the connectAccountWithRedirect API to use a dedicated
scopes parameter instead of nesting it within authorization_params.
- Updated documentation examples to reflect the new API structure for
connecting third-party accounts.

### 🧪 Testing
- Verified unit test

### 💥 Impact
- Developers will have a cleaner API for specifying scopes when
connecting third-party accounts.
- The update improves consistency with other Auth0 SDK methods that use
a top-level scopes parameter.
- No breaking changes expected as this appears to be an API enhancement.

### 📋 Checklist
- [ ] Code follows the project's coding standards
- [ ] Tests have been added/updated
- [ ] Documentation has been updated
- [ ] All tests are passing

---------

Co-authored-by: guabu <[email protected]>
Co-authored-by: Arpit Jain <[email protected]>

Author: 3 people

EXAMPLES.md

@@ -658,9 +658,9 @@ const ConnectAccount = () => {
   const { connectAccountWithRedirect } = useAuth0();
   return <button onClick={() => connectAccountWithRedirect({
     connection: '<CONNECTION eg, google-apps-connection>',
-    access_type: 'offline', // You must also request a refresh token from the third party Identity Provider for it to be stored in Token Vault.
+    scopes: ['<SCOPE eg https://www.googleapis.com/auth/calendar.acls.readonly>'],
     authorization_params: {
-      scope: '<SCOPE eg https://www.googleapis.com/auth/calendar.acls.readonly>'
+      // additional authorization params to forward to the authorization server
     }
   })}>Connect Google Calendar</button>;
 };

package-lock.json

@@ -95,6 +95,6 @@
     "react-dom": "^16.11.0 || ^17 || ^18 || ^19"
   },
   "dependencies": {
-    "@auth0/auth0-spa-js": "^2.7.0"
+    "@auth0/auth0-spa-js": "^2.9.0"
   }
 }

package.json

@@ -126,9 +126,9 @@ export interface Auth0ContextInterface<TUser extends User = User>
    * ```js
    * await connectAccountWithRedirect({
    *   connection: 'google-oauth2',
-   *   authorizationParams: {
-   *     access_type: 'offline',
-   *     scope: 'openid profile email https://www.googleapis.com/auth/drive.readonly',
+   *   scopes: ['openid', 'profile', 'email', 'https://www.googleapis.com/auth/drive.readonly'],
+   *   authorization_params: {
+   *     // additional authorization params to forward to the authorization server
    *   }
    * });
    * ```