refactor(api): apply review comments

Author: bpetetot

api/src/identity-access-management/application/token/token.controller.js

@@ -33,6 +33,7 @@ const createToken = async function (request, h, dependencies = { tokenService })
     refreshToken = request.payload.refresh_token;
 
     // TODO: we should pass the scope when ember-simple-auth will pass it
+    // see https://github.com/mainmatter/ember-simple-auth/pull/2813 for further details
     const tokensInfo = await usecases.createAccessTokenFromRefreshToken({ refreshToken });
 
     accessToken = tokensInfo.accessToken;

api/src/identity-access-management/domain/services/refresh-token-service.js

@@ -12,7 +12,7 @@ const REFRESH_TOKEN_EXPIRATION_DELAY_ADDITION_SECONDS = 60 * 60; // 1 hour
 
 /**
  * @param refreshToken
- * @returns {Promise<{userId: string, source: string}>}
+ * @returns {Promise<{userId: string, source: string, scope: string}>}
  */
 async function findByRefreshToken(refreshToken) {
   return refreshTokenTemporaryStorage.get(refreshToken);