feat(api): add create flow endpoint for users

packages/backend/src/controllers/api/v1/flows/create-flow.ee.test.js

@@ -0,0 +1,74 @@
+import Crypto from 'node:crypto';
+import request from 'supertest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import app from '../../../../app.js';
+import { createApiToken } from '../../../../../test/factories/api-token.js';
+import { createTemplate } from '../../../../../test/factories/template.js';
+import { createUser } from '../../../../../test/factories/user.js';
+import createFlowMock from '../../../../../test/mocks/rest/api/v1/users/create-flow.js';
+import * as license from '../../../../helpers/license.ee.js';
+
+describe('POST /api/v1/users/:userId/flows', () => {
+  let user, token;
+
+  beforeEach(async () => {
+    vi.spyOn(license, 'hasValidLicense').mockResolvedValue(true);
+
+    user = await createUser();
+    token = (await createApiToken()).token;
+  });
+
+  it('should create an empty flow when no templateId is provided for the given user', async () => {
+    const response = await request(app)
+      .post(`/api/v1/users/${user.id}/flows`)
+      .set('x-api-token', token)
+      .expect(201);
+
+    const refetchedFlow = await user
+      .$relatedQuery('flows')
+      .findById(response.body.data.id);
+
+    const expectedPayload = await createFlowMock(refetchedFlow);
+
+    expect(response.body).toMatchObject(expectedPayload);
+  });
+
+  it('should create a flow from template when templateId is provided for the given user', async () => {
+    const template = await createTemplate({
+      name: 'Sample template',
+    });
+
+    const response = await request(app)
+      .post(`/api/v1/users/${user.id}/flows`)
+      .query({ templateId: template.id })
+      .set('x-api-token', token)
+      .expect(201);
+
+    expect(response.body.data.name).toBe(template.flowData.name);
+  });
+
+  it('should return an error when an invalid templateId is provided', async () => {
+    await request(app)
+      .post(`/api/v1/users/${user.id}/flows`)
+      .query({ templateId: 'invalid-template-id' })
+      .set('x-api-token', token)
+      .expect(400);
+  });
+
+  it('should respond with HTTP 404 for non-existent user', async () => {
+    const notExistingUserId = Crypto.randomUUID();
+
+    await request(app)
+      .get(`/api/v1/users/${notExistingUserId}/folders`)
+      .set('x-api-token', token)
+      .expect(404);
+  });
+
+  it('should return bad request response for invalid user UUID', async () => {
+    await request(app)
+      .get(`/api/v1/users/invalidUserUUID/folders`)
+      .set('x-api-token', token)
+      .expect(400);
+  });
+});

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

@@ -0,0 +1,16 @@
+import { renderObject } from '../../../../helpers/renderer.js';
+import User from '../../../../models/user.js';
+
+export default async (request, response) => {
+  const { templateId } = request.query;
+
+  const user = await User.query()
+    .findById(request.params.userId)
+    .throwIfNotFound();
+
+  const flow = templateId
+    ? await user.createFlowFromTemplate(templateId)
+    : await user.createEmptyFlow();
+
+  renderObject(response, flow, { status: 201 });
+};