Add support for scope parameter on start_connect_account

Author: sam-muncke

src/auth0_server_python/auth_server/server_client.py

@@ -1318,12 +1318,14 @@ async def start_connect_account(
 
         connect_request = ConnectAccountRequest(
             connection=options.connection,
+            scope=" ".join(options.scope) if options.scope else None,
             redirect_uri = redirect_uri,
             code_challenge=code_challenge,
             code_challenge_method="S256",
             state=state,
             authorization_params=options.authorization_params
         )
+
         access_token = await self.get_access_token(
             audience=self._my_account_client.audience_identifier,
             scope="create:me:connected_accounts",

src/auth0_server_python/auth_types/__init__.py

@@ -219,11 +219,13 @@ class ConnectParams(BaseModel):
 class ConnectAccountOptions(BaseModel):
     connection: str
     redirect_uri: Optional[str] = None
+    scope: Optional[list[str]] = None
     app_state: Optional[Any] = None
     authorization_params: Optional[dict[str, Any]] = None
 
 class ConnectAccountRequest(BaseModel):
     connection: str
+    scope: Optional[str] = None
     redirect_uri: Optional[str] = None
     state: Optional[str] = None
     code_challenge: Optional[str] = None

src/auth0_server_python/tests/test_server_client.py

@@ -1324,6 +1324,47 @@ async def test_start_connect_account_calls_connect_and_builds_url(mocker):
         options=ANY
     )
 
+@pytest.mark.asyncio
+async def test_start_connect_account_with_scope(mocker):
+    # Setup
+    mock_transaction_store = AsyncMock()
+    mock_state_store = AsyncMock()
+
+    client = ServerClient(
+        domain="auth0.local",
+        client_id="<client_id>",
+        client_secret="<client_secret>",
+        state_store=mock_state_store,
+        transaction_store=mock_transaction_store,
+        secret="some-secret"
+    )
+
+    mocker.patch.object(client, "get_access_token", AsyncMock(return_value="<access_token>"))
+    mock_my_account_client = AsyncMock(MyAccountClient)
+    mocker.patch.object(client, "_my_account_client", mock_my_account_client)
+    mock_my_account_client.connect_account.return_value = ConnectAccountResponse(
+        auth_session="<auth_session>",
+        connect_uri="http://auth0.local/connected_accounts/connect",
+        connect_params=ConnectParams(
+            ticket="ticket123"
+        ),
+        expires_in=300
+    )
+
+    # Act
+    await client.start_connect_account(
+        options=ConnectAccountOptions(
+            connection="<connection>",
+            scope=["scope1", "scope2", "scope3"],
+            redirect_uri="/test_redirect_uri"
+        )
+    )
+
+    # Assert
+    mock_my_account_client.connect_account.assert_awaited()
+    request = mock_my_account_client.connect_account.mock_calls[0].kwargs["request"]
+    assert request.scope == "scope1 scope2 scope3"
+    
 @pytest.mark.asyncio
 async def test_start_connect_account_default_redirect_uri(mocker):
     # Setup