2038 zapier integration 1 initialize a zapier app with a twenty related account (#2089)

* Add doc for Zapier development

* Add twenty-zapier package

* Install zapier packages

* Update doc

* Add twenty-zapier app

* Update doc

* Update apiKey slug

* Update integration

* Update create people to person

* Update version

* Fix lint

* Remove useless comments

* Update docs

* Update version

* Update naming

* Add prettier

* Simplify docs

* Remove twenty related stuff from public doc

* Use typescript boilerplate

* Update details

packages/twenty-zapier/src/test/authentication.test.ts

@@ -0,0 +1,75 @@
+import App from '../index';
+import {
+  Bundle,
+  HttpRequestOptions,
+  createAppTester,
+  tools,
+  ZObject,
+  AppError,
+} from 'zapier-platform-core';
+const appTester = createAppTester(App);
+tools.env.inject();
+
+const generateKey = async (z: ZObject, bundle: Bundle) => {
+  const options = {
+    url: `${process.env.SERVER_BASE_URL}/graphql`,
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${bundle.authData.apiKey}`,
+    },
+    body: {
+      query: `mutation 
+      CreateApiKey {
+      createOneApiKey(data:{
+      name:"${bundle.inputData.name}", 
+      expiresAt: "${bundle.inputData.expiresAt}"
+      }) {token}}`,
+    },
+  } satisfies HttpRequestOptions;
+  return z.request(options).then((response) => {
+    const results = response.json;
+    return results.data.createOneApiKey.token;
+  });
+};
+
+const apiKey = String(process.env.API_KEY);
+
+describe('custom auth', () => {
+  it('passes authentication and returns json', async () => {
+    const bundle = { authData: { apiKey } };
+    const response = await appTester(App.authentication.test, bundle);
+    expect(response.data).toHaveProperty('currentWorkspace');
+    expect(response.data.currentWorkspace).toHaveProperty('displayName');
+  });
+
+  it('fails on bad auth token format', async () => {
+    const bundle = { authData: { apiKey: 'bad' } };
+
+    try {
+      await appTester(App.authentication.test, bundle);
+    } catch (error: any) {
+      expect(error.message).toContain('The API Key you supplied is incorrect');
+      return;
+    }
+    throw new Error('appTester should have thrown');
+  });
+
+  it('fails on invalid auth token', async () => {
+    const bundle = {
+      authData: { apiKey },
+      inputData: { name: 'Test', expiresAt: '2020-01-01 10:10:10.000' },
+    };
+    const expiredToken = await appTester(generateKey, bundle);
+    const bundleWithExpiredApiKey = {
+      authData: { apiKey: expiredToken },
+    };
+
+    try {
+      await appTester(App.authentication.test, bundleWithExpiredApiKey);
+    } catch (error: any) {
+      expect(error.message).toContain('The API Key you supplied is incorrect');
+      return;
+    }
+    throw new Error('appTester should have thrown');
+  });
+});

packages/twenty-zapier/src/test/creates/create_person.test.ts

@@ -0,0 +1,25 @@
+import App from '../../index';
+import { createAppTester, tools } from 'zapier-platform-core';
+const appTester = createAppTester(App);
+tools.env.inject();
+
+describe('creates.create_person', () => {
+  test('should run', async () => {
+    const bundle = {
+      authData: { apiKey: String(process.env.API_KEY) },
+      inputData: {
+        firstName: 'John',
+        lastName: 'Doe',
+        email: 'johndoe@gmail.com',
+        phone: '+33610203040',
+        city: 'Paris',
+      },
+    };
+    const results = await appTester(
+      App.creates.create_person.operation.perform,
+      bundle,
+    );
+    expect(results).toBeDefined();
+    expect(results.data?.createOnePerson?.id).toBeDefined();
+  });
+});