Merge pull request #318 from IQSS/300-user-roles

Add GetUserSelectableRoles use case

Author: ofahimIQSS

docs/useCases.md

@@ -75,6 +75,9 @@ The different use cases currently available in the package are classified below,
     - [Delete Current API Token](#delete-current-api-token)
     - [Recreate Current API Token](#recreate-current-api-token)
     - [Register User](#register-user)
+- [Roles](#Roles)
+  - [Roles read use cases](#roles-read-use-cases)
+    - [Get User Selectable Roles](#get-user-selectable-roles)
 - [Info](#Info)
   - [Get Dataverse Backend Version](#get-dataverse-backend-version)
   - [Get Maximum Embargo Duration In Months](#get-maximum-embargo-duration-in-months)
@@ -1842,6 +1845,28 @@ registerUser.execute(userDTO)
 
 _See [use case](../src/users/domain/useCases/RegisterUser.ts) implementation_.
 
+## Roles
+
+### Get User Selectable Roles
+
+Returns a [Role](../src/roles/domain/models/Role.ts) array that the calling user can use as filters when searching within their data.
+
+##### Example call:
+
+```typescript
+import { getUserSelectableRoles } from '@iqss/dataverse-client-javascript'
+
+/* ... */
+
+getUserSelectableRoles.execute().then((roles: Role[]) => {
+  /* ... */
+})
+
+/* ... */
+```
+
+_See [use case](../src/roles/domain/useCases/GetUserSelectableRoles.ts) implementation_.
+
 ## Info
 
 #### Get Dataverse Backend Version

src/index.ts

@@ -1,6 +1,7 @@
 export * from './core'
 export * from './info'
 export * from './users'
+export * from './roles'
 export * from './auth'
 export * from './datasets'
 export * from './collections'

src/roles/domain/models/Role.ts

@@ -0,0 +1,7 @@
+export interface Role {
+  id: number
+  name: string
+  alias: string
+  description: string
+  permissions: string[]
+}

src/roles/domain/repositories/IRolesRepository.ts

@@ -0,0 +1,5 @@
+import { Role } from '../models/Role'
+
+export interface IRolesRepository {
+  getUserSelectableRoles(): Promise<Role[]>
+}

src/roles/domain/repositories/transformers/RolePayload.ts

@@ -0,0 +1,7 @@
+export interface RolePayload {
+  id: number
+  name: string
+  alias: string
+  description: string
+  permissions: string[]
+}

src/roles/domain/repositories/transformers/roleTransformers.ts

@@ -0,0 +1,15 @@
+import { AxiosResponse } from 'axios'
+import { Role } from '../../models/Role'
+import { RolePayload } from './RolePayload'
+
+export const transformRolesUserSelectableResponseToRoles = (response: AxiosResponse): Role[] => {
+  const roleUserSelectablePayload = response.data.data as RolePayload[]
+
+  return roleUserSelectablePayload.map((role: RolePayload) => ({
+    id: role.id,
+    name: role.name,
+    alias: role.alias,
+    description: role.description,
+    permissions: role.permissions
+  }))
+}

src/roles/domain/useCases/GetUserSelectableRoles.ts

@@ -0,0 +1,16 @@
+import { UseCase } from '../../../core/domain/useCases/UseCase'
+import { Role } from '../models/Role'
+import { IRolesRepository } from '../repositories/IRolesRepository'
+
+export class GetUserSelectableRoles implements UseCase<Role[]> {
+  constructor(private readonly rolesRepository: IRolesRepository) {}
+
+  /**
+   * Returns the appropriate roles that the calling user can use as filters when searching within their data.
+   *
+   * @returns {Promise<Role[]>} - A promise that resolves to an array of Role instances.
+   */
+  async execute(): Promise<Role[]> {
+    return (await this.rolesRepository.getUserSelectableRoles()) as Role[]
+  }
+}

src/roles/index.ts

@@ -0,0 +1,10 @@
+import { RolesRepository } from './infra/repositories/RolesRepository'
+import { GetUserSelectableRoles } from './domain/useCases/GetUserSelectableRoles'
+
+const rolesRepository = new RolesRepository()
+
+const getUserSelectableRoles = new GetUserSelectableRoles(rolesRepository)
+
+export { getUserSelectableRoles }
+
+export { Role } from './domain/models/Role'

src/roles/infra/repositories/RolesRepository.ts

@@ -0,0 +1,15 @@
+import { ApiRepository } from '../../../core/infra/repositories/ApiRepository'
+import { IRolesRepository } from '../../domain/repositories/IRolesRepository'
+import { Role } from '../../domain/models/Role'
+import { transformRolesUserSelectableResponseToRoles } from '../../domain/repositories/transformers/roleTransformers'
+
+export class RolesRepository extends ApiRepository implements IRolesRepository {
+  private readonly rolesResourceName: string = 'roles'
+  public async getUserSelectableRoles(): Promise<Role[]> {
+    return this.doGet(`/${this.rolesResourceName}/userSelectable`, true)
+      .then((response) => transformRolesUserSelectableResponseToRoles(response))
+      .catch((error) => {
+        throw error
+      })
+  }
+}

test/integration/roles/RolesRepository.test.ts

@@ -0,0 +1,23 @@
+import {
+  ApiConfig,
+  DataverseApiAuthMechanism
+} from '../../../src/core/infra/repositories/ApiConfig'
+import { TestConstants } from '../../testHelpers/TestConstants'
+import { RolesRepository } from '../../../src/roles/infra/repositories/RolesRepository'
+import { createSuperAdminRoleArray } from '../../testHelpers/roles/roleHelper'
+
+describe('RolesRepository', () => {
+  const sut: RolesRepository = new RolesRepository()
+
+  describe('getUserSelectableRoles', () => {
+    test('should return list of selectable roles for authenticated user', async () => {
+      ApiConfig.init(
+        TestConstants.TEST_API_URL,
+        DataverseApiAuthMechanism.API_KEY,
+        process.env.TEST_API_KEY
+      )
+      const actual = await sut.getUserSelectableRoles()
+      expect(actual).toStrictEqual(createSuperAdminRoleArray())
+    })
+  })
+})