feat: Implement create folder API endpoint

packages/backend/src/controllers/api/v1/folders/create-folder.js

@@ -0,0 +1,11 @@
+import { renderObject } from '../../../../helpers/renderer.js';
+
+export default async (request, response) => {
+  const folder = await request.currentUser
+    .$relatedQuery('folders')
+    .insertAndFetch({
+      name: request.body.name,
+    });
+
+  renderObject(response, folder, { status: 201 });
+};

packages/backend/src/controllers/api/v1/folders/create-folder.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import request from 'supertest';
+import app from '../../../../app.js';
+import createAuthTokenByUserId from '../../../../helpers/create-auth-token-by-user-id.js';
+import { createUser } from '../../../../../test/factories/user.js';
+import createFolderMock from '../../../../../test/mocks/rest/api/v1/folders/create-folder.js';
+import { createPermission } from '../../../../../test/factories/permission.js';
+
+describe('POST /api/v1/folders', () => {
+  let currentUser, currentUserRole, token;
+
+  beforeEach(async () => {
+    currentUser = await createUser();
+    currentUserRole = await currentUser.$relatedQuery('role');
+
+    token = await createAuthTokenByUserId(currentUser.id);
+  });
+
+  it('should return created flow', async () => {
+    await createPermission({
+      action: 'create',
+      subject: 'Flow',
+      roleId: currentUserRole.id,
+      conditions: ['isCreator'],
+    });
+
+    const response = await request(app)
+      .post('/api/v1/folders')
+      .set('Authorization', token)
+      .send({
+        name: 'Test Folder',
+      })
+      .expect(201);
+
+    const refetchedFolder = await currentUser
+      .$relatedQuery('folders')
+      .findById(response.body.data.id);
+
+    const expectedPayload = await createFolderMock(refetchedFolder);
+
+    expect(response.body).toMatchObject(expectedPayload);
+  });
+});