Added: docs for new API token management use cases

Author: GPortas

docs/useCases.md

@@ -52,6 +52,10 @@ The different use cases currently available in the package are classified below,
 - [Users](#Users)
   - [Users read use cases](#users-read-use-cases)
     - [Get Current Authenticated User](#get-current-authenticated-user)
+    - [Get Current API Token](#get-current-api-token)
+  - [Users write use cases](#users-write-use-cases)
+    - [Delete Current API Token](#delete-current-api-token)
+    - [Recreate Current API Token](#recreate-current-api-token)
 - [Info](#Info)
   - [Get Dataverse Backend Version](#get-dataverse-backend-version)
   - [Get Maximum Embargo Duration In Months](#get-maximum-embargo-duration-in-months)
@@ -1137,6 +1141,66 @@ getCurrentAuthenticatedUser.execute().then((user: AuthenticatedUser) => {
 
 _See [use case](../src/users/domain/useCases/GetCurrentAuthenticatedUser.ts) implementation_.
 
+### Get Current API Token
+
+Returns the current [ApiTokenInfo](../src/users/domain/models/ApiTokenInfo.ts) corresponding to the current authenticated user.
+
+##### Example call:
+
+```typescript
+import { getCurrentApiToken } from '@iqss/dataverse-client-javascript'
+
+/* ... */
+
+getCurrentApiToken.execute().then((apiTokenInfo: ApiTokenInfo) => {
+  /* ... */
+})
+
+/* ... */
+```
+
+_See [use case](../src/users/domain/useCases/GetCurrentApiToken.ts) implementation_.
+
+### Users write use cases
+
+### Delete Current API Token
+
+Deletes the API token of the current authenticated user.
+
+##### Example call:
+
+```typescript
+import { deleteCurrentApiToken } from '@iqss/dataverse-client-javascript'
+
+/* ... */
+
+deleteCurrentApiToken.execute()
+
+/* ... */
+```
+
+_See [use case](../src/users/domain/useCases/DeleteCurrentApiToken.ts) implementation_.
+
+### Recreate Current API Token
+
+Reacreates the API token of the current authenticated user and returns the new [ApiTokenInfo](../src/users/domain/models/ApiTokenInfo.ts).
+
+##### Example call:
+
+```typescript
+import { recreateCurrentApiToken } from '@iqss/dataverse-client-javascript'
+
+/* ... */
+
+recreateCurrentApiToken.execute().then((apiTokenInfo: ApiTokenInfo) => {
+  /* ... */
+})
+
+/* ... */
+```
+
+_See [use case](../src/users/domain/useCases/RecreateCurrentApiToken.ts) implementation_.
+
 ## Info
 
 #### Get Dataverse Backend Version

src/users/domain/useCases/DeleteCurrentApiToken.ts

@@ -9,7 +9,7 @@ export class DeleteCurrentApiToken implements UseCase<void> {
   }
 
   /**
-   * Deletes the API token of the current authenticated user in ApiConfig.
+   * Deletes the API token of the current authenticated user.
    *
    * @returns {Promise<void>}
    */

src/users/domain/useCases/GetCurrentApiToken.ts

@@ -10,7 +10,7 @@ export class GetCurrentApiToken implements UseCase<ApiTokenInfo> {
   }
 
   /**
-   * Returns the current API token information corresponding to the current user authenticated through ApiConfig.
+   * Returns the current ApiTokenInfo corresponding to the current authenticated user.
    *
    * @returns {Promise<ApiTokenInfo>}
    */

src/users/domain/useCases/RecreateCurrentApiToken.ts

@@ -10,7 +10,7 @@ export class RecreateCurrentApiToken implements UseCase<ApiTokenInfo> {
   }
 
   /**
-   * Reacreates the API token of the current authenticated user in ApiConfig and returns the new API token info.
+   * Reacreates the API token of the current authenticated user and returns the new ApiTokenInfo.
    *
    * @returns {Promise<ApiTokenInfo>}
    */