feat(api): add get users endpoint

packages/backend/src/controllers/api/v1/users/get-users.ee.js

@@ -0,0 +1,15 @@
+import paginateRest from '../../../../helpers/pagination.js';
+import { renderObject } from '../../../../helpers/renderer.js';
+import User from '../../../../models/user.js';
+
+export default async (request, response) => {
+  const usersQuery = User.query()
+    .withGraphFetched({
+      role: true,
+    })
+    .orderBy('full_name', 'asc');
+
+  const users = await paginateRest(usersQuery, request.query.page);
+
+  renderObject(response, users);
+};

packages/backend/src/controllers/api/v1/users/get-users.ee.test.js

@@ -0,0 +1,48 @@
+import request from 'supertest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createApiToken } from '../../../../../test/factories/api-token.js';
+import { createRole } from '../../../../../test/factories/role.js';
+import { createUser } from '../../../../../test/factories/user.js';
+import getUsersMock from '../../../../../test/mocks/rest/internal/api/v1/admin/users/get-users.js';
+import app from '../../../../app.js';
+import * as license from '../../../../helpers/license.ee.js';
+
+describe('GET /api/v1/users', () => {
+  let userOne, userOneRole, userTwo, userTwoRole, token;
+
+  beforeEach(async () => {
+    vi.spyOn(license, 'hasValidLicense').mockResolvedValue(true);
+
+    userOneRole = await createRole({ name: 'Admin' });
+
+    userOne = await createUser({
+      roleId: userOneRole.id,
+      fullName: 'User 1',
+    });
+
+    userTwoRole = await createRole({
+      name: 'Another user role',
+    });
+
+    userTwo = await createUser({
+      roleId: userTwoRole.id,
+      fullName: 'User 2',
+    });
+
+    token = (await createApiToken()).token;
+  });
+
+  it('should return users data', async () => {
+    const response = await request(app)
+      .get('/api/v1/users')
+      .set('x-api-token', token)
+      .expect(200);
+
+    const expectedResponsePayload = await getUsersMock(
+      [userOne, userTwo],
+      [userOneRole, userTwoRole]
+    );
+
+    expect(response.body).toStrictEqual(expectedResponsePayload);
+  });
+});