4655 batch endpoints on the rest api (#5411)

- add POST rest/batch/<OBJECT> endpoint
- rearrange rest api code with Twenty quality standard
- unify REST API error format
- Added PATCH verb to update objects
- In openapi schema, we replaced PUT with PATCH verb to comply with REST
standard
- fix openApi schema to match the REST api

### Batch Create

![image](https://github.com/twentyhq/twenty/assets/29927851/fe8cd91d-7b35-477f-9077-3477b57b054c)

### Replace PUT by PATCH in open Api

![image](https://github.com/twentyhq/twenty/assets/29927851/9a95060d-0b21-4a04-a3fa-c53390897b5b)

### Error format unification

![image](https://github.com/twentyhq/twenty/assets/29927851/f47dfcef-a4f8-4f93-8504-22f82a8d8057)

![image](https://github.com/twentyhq/twenty/assets/29927851/d76a87e2-2bf6-4ed9-a142-71ad7c123beb)

![image](https://github.com/twentyhq/twenty/assets/29927851/6db59ad3-0ba7-4390-a02d-be15884e2516)

packages/twenty-server/src/engine/api/rest/utils/__tests__/clean-graphql-response.utils.spec.ts

@@ -0,0 +1,53 @@
+import { cleanGraphQLResponse } from 'src/engine/api/rest/utils/clean-graphql-response.utils';
+
+describe('cleanGraphQLResponse', () => {
+  it('should remove edges/node from results', () => {
+    const data = {
+      companies: {
+        edges: [
+          {
+            node: { id: 'id', createdAt: '2023-01-01' },
+          },
+        ],
+      },
+    };
+    const expectedResult = {
+      companies: [{ id: 'id', createdAt: '2023-01-01' }],
+    };
+
+    expect(cleanGraphQLResponse(data)).toEqual(expectedResult);
+  });
+  it('should remove nested edges/node from results', () => {
+    const data = {
+      companies: {
+        edges: [
+          {
+            node: {
+              id: 'id',
+              createdAt: '2023-01-01',
+              people: {
+                edges: [{ node: { id: 'id1' } }, { node: { id: 'id2' } }],
+              },
+            },
+          },
+        ],
+      },
+    };
+    const expectedResult = {
+      companies: [
+        {
+          id: 'id',
+          createdAt: '2023-01-01',
+          people: [{ id: 'id1' }, { id: 'id2' }],
+        },
+      ],
+    };
+
+    expect(cleanGraphQLResponse(data)).toEqual(expectedResult);
+  });
+  it('should not format when no list returned', () => {
+    const data = { company: { id: 'id' } };
+
+    expect(cleanGraphQLResponse(data)).toEqual(data);
+  });
+});

packages/twenty-server/src/engine/api/rest/utils/clean-graphql-response.utils.ts

@@ -0,0 +1,22 @@
+// https://gist.github.com/ManUtopiK/469aec75b655d6a4d912aeb3b75af3c9
+export const cleanGraphQLResponse = (input: any) => {
+  if (!input) return null;
+  const output = {};
+  const isObject = (obj: any) => {
+    return obj !== null && typeof obj === 'object' && !Array.isArray(obj);
+  };
+
+  Object.keys(input).forEach((key) => {
+    if (input[key] && input[key].edges) {
+      output[key] = input[key].edges.map((edge) =>
+        cleanGraphQLResponse(edge.node),
+      );
+    } else if (isObject(input[key])) {
+      output[key] = cleanGraphQLResponse(input[key]);
+    } else if (key !== '__typename') {
+      output[key] = input[key];
+    }
+  });
+
+  return output;
+};