PR review fix & improvements

README.md

@@ -33,6 +33,7 @@ complete each is detailed in the comments.
 For readability purpose, we replace `ReaderTaskEither` by `rte`
 
 - Use `flow` instead of `pipe` when possible
+  > Why? Using flow reduces the amount of variables to declare in a method, hence the visibility and readability of the code
 
 ```typescript
 // Bad
@@ -52,8 +53,7 @@ const triggerEmailCampaign = ({
   user,
   ...emailSettings
 }: {
-  user: User & EmailSettings;
+  user: User} & EmailSettings) =>
-}) =>
   pipe(
     user.nationality === 'FR',
     boolean.match(
@@ -65,15 +65,12 @@ const triggerEmailCampaign = ({
 // Good
 const triggerEmailCampaign = ({
   user,
-  ...otherProps
+  ...emailSettings
-}: {
+}: { user: User } & EmailSettings) => {
-  user: User & OtherProps;
-}) => {
   if (user.nationality === 'FR') {
     return triggerFrenchEmailCampaign({ to: user.email, emailSettings });
   }
   return triggerGlobalEmailCampain({ to: user.email, emailSettings });
-};
 ```
 
 - Avoid nested pipes
@@ -81,14 +78,14 @@ const triggerEmailCampaign = ({
 
 ```typescript
 // Bad
-const renewUserToken = (user: User) =>
+const refreshUserToken = (user: User) =>
   pipe(
     user.token,
     option.match(
       () => AuthClient.createToken(user),
       (token) =>
-        flow(
+        pipe(
-          AuthClient.renewToken(user),
+          AuthClient.refreshToken({ user, token }),
           rte.chainW(({ newToken }) =>
             pipe(newToken.hash, user.updateToken, rte.chainEitherKW(storeUser)),
           ),
@@ -97,16 +94,16 @@ const renewUserToken = (user: User) =>
   );
 
 // Good
-const updateUserToken = (user: User) => (newToken: Token) =>
+const updateUserToken = (user: User) =>
-  pipe(newToken.hash, user.updateToken, rte.chainEitherKW(storeUser));
+  flow(user.updateToken, rte.chainEitherKW(storeUser));
 
-const renewAndUpdateUserToken = (user: User) =>
+const refreshAndUpdateUserToken = (user: User) => (token: Token) =>
-  flow(
+  pipe(
-    AuthClient.renewToken(user),
+    AuthClient.refreshToken({ user, token }),
-    rte.chainW(({ newToken }) => updateUserToken(user)),
+    rte.chainW(({ newToken }) => updateUserToken(user)(newToken.hash)),
   );
 
-const renewUserToken = (user: User) =>
+const refreshUserToken = (user: User) =>
   pipe(
     user.token,
     option.match(