feat(odoo): add auth and create lead action (#1143)

* Add Odoo App and Icon

* Add Auth for Odoo

* Authorise with API key, the password would also work, but we should encourage an API key.

* Odoo Verify Credentials method

* Add the xmlrpc dependency so the backend can communicate with Odoo's API.
* Add a port to the auth fields to establish a connection that might not be over HTTPS.

* Add still verified method

* Currently no need to keep uid, so remove it from the auth data.
* Await the callback from the xmlrpc method call to ensure we don't verify credentials before the callback has been executed.

* Add Odoo create-lead action

* Provide basic functionality to create a lead.

* Add Odoo type option

* Let the user decide if the lead should be a "lead" or "opportunity" in the create-lead action.

* Add documentation for Odoo app

* Follow project standards

* Change indents to 2 spaces
* Use single quotes instead of double

* Commonise the authentication method (DRY)

* Use latest for API doc link

* refactor(odoo): abstract and organize implementation

---------

Co-authored-by: Ali BARIN <ali.barin53@gmail.com>

packages/backend/src/apps/odoo/actions/create-lead/index.ts

@@ -0,0 +1,103 @@
+import defineAction from '../../../../helpers/define-action';
+import { authenticate, asyncMethodCall } from '../../common/xmlrpc-client';
+
+export default defineAction({
+  name: 'Create Lead',
+  key: 'createLead',
+  description: '',
+  arguments: [
+    {
+      label: 'Name',
+      key: 'name',
+      type: 'string' as const,
+      required: true,
+      description: 'Lead name',
+      variables: true,
+    },
+    {
+      label: 'Type',
+      key: 'type',
+      type: 'dropdown' as const,
+      required: true,
+      variables: true,
+      options: [
+        {
+          label: 'Lead',
+          value: 'lead'
+        },
+        {
+          label: 'Opportunity',
+          value: 'opportunity'
+        }
+      ]
+    },
+    {
+      label: "Email",
+      key: 'email',
+      type: 'string' as const,
+      required: false,
+      description: 'Email of lead contact',
+      variables: true,
+    },
+    {
+      label: "Contact Name",
+      key: 'contactName',
+      type: 'string' as const,
+      required: false,
+      description: 'Name of lead contact',
+      variables: true
+    },
+    {
+      label: 'Phone Number',
+      key: 'phoneNumber',
+      type: 'string' as const,
+      required: false,
+      description: 'Phone number of lead contact',
+      variables: true
+    },
+    {
+      label: 'Mobile Number',
+      key: 'mobileNumber',
+      type: 'string' as const,
+      required: false,
+      description: 'Mobile number of lead contact',
+      variables: true
+    }
+  ],
+
+  async run($) {
+    const uid = await authenticate($);
+    const id = await asyncMethodCall(
+      $,
+      {
+        method: 'execute_kw',
+        params: [
+          $.auth.data.databaseName,
+          uid,
+          $.auth.data.apiKey,
+          'crm.lead',
+          'create',
+          [
+            {
+              name: $.step.parameters.name,
+              type: $.step.parameters.type,
+              email_from: $.step.parameters.email,
+              contact_name: $.step.parameters.contactName,
+              phone: $.step.parameters.phoneNumber,
+              mobile: $.step.parameters.mobileNumber
+            }
+          ]
+        ],
+        path: 'object',
+      },
+    );
+
+    $.setActionItem(
+      {
+        raw: {
+          id: id
+        }
+      }
+    )
+  }
+});

packages/backend/src/apps/odoo/actions/index.ts

@@ -0,0 +1,3 @@
+import createLead from './create-lead';
+
+export default [createLead];

packages/backend/src/apps/odoo/assets/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="600" height="191"><circle cx="527.5" cy="118.4" r="72.4" fill="#888"/><path d="M527.5 161.1c23.6 0 42.7-19.1 42.7-42.7s-19.1-42.7-42.7-42.7-42.7 19.1-42.7 42.7 19.1 42.7 42.7 42.7z" fill="#fff"/><circle cx="374" cy="118.4" r="72.4" fill="#888"/><path d="M374 161.1c23.6 0 42.7-19.1 42.7-42.7S397.6 75.7 374 75.7s-42.7 19.1-42.7 42.7 19.1 42.7 42.7 42.7z" fill="#fff"/><path d="M294.9 117.8v.6c0 40-32.4 72.4-72.4 72.4s-72.4-32.4-72.4-72.4S182.5 46 222.5 46c16.4 0 31.5 5.5 43.7 14.6V14.4A14.34 14.34 0 0 1 280.6 0c7.9 0 14.4 6.5 14.4 14.4v102.7c0 .2 0 .5-.1.7z" fill="#888"/><circle cx="222.5" cy="118.4" r="42.7" fill="#fff"/><circle cx="72.4" cy="118.2" r="72.4" fill="#9c5789"/><circle cx="71.7" cy="118.5" r="42.7" fill="#fff"/><script xmlns=""/></svg>

packages/backend/src/apps/odoo/auth/index.ts

@@ -0,0 +1,65 @@
+import verifyCredentials from './verify-credentials';
+import isStillVerified from './is-still-verified';
+
+export default {
+  fields: [
+    {
+      key: 'host',
+      label: 'Host Name',
+      type: 'string' as const,
+      required: true,
+      readOnly: false,
+      value: null,
+      placeholder: null,
+      description: 'Host name of your Odoo Server',
+      clickToCopy: false,
+    },
+    {
+      key: 'port',
+      label: 'Port',
+      type: 'string' as const,
+      required: true,
+      readOnly: false,
+      value: '443',
+      placeholder: null,
+      description: 'Port that the host is running on, defaults to 443 (HTTPS)',
+      clickToCopy: false,
+    },
+    {
+      key: 'databaseName',
+      label: 'Database Name',
+      type: 'string' as const,
+      required: true,
+      readOnly: false,
+      value: null,
+      placeholder: null,
+      description: 'Name of your Odoo database',
+      clickToCopy: false,
+    },
+    {
+      key: 'email',
+      label: 'Email Address',
+      type: 'string' as const,
+      requires: true,
+      readOnly: false,
+      value: null,
+      placeholder: null,
+      description: 'Email Address of the account that will be interacting with the database',
+      clickToCopy: false
+    },
+    {
+      key: 'apiKey',
+      label: 'API Key',
+      type: 'string' as const,
+      required: true,
+      readOnly: false,
+      value: null,
+      placeholder: null,
+      description: 'API Key for your Odoo account',
+      clickToCopy: false
+    }
+  ],
+
+  verifyCredentials,
+  isStillVerified
+};

packages/backend/src/apps/odoo/auth/is-still-verified.ts

@@ -0,0 +1,9 @@
+import {IGlobalVariable} from '@automatisch/types';
+import verifyCredentials from './verify-credentials';
+
+const isStillVerified = async ($: IGlobalVariable) => {
+  await verifyCredentials($);
+  return true;
+}
+
+export default isStillVerified;

packages/backend/src/apps/odoo/auth/verify-credentials.ts

@@ -0,0 +1,16 @@
+import { IGlobalVariable } from '@automatisch/types';
+import { authenticate } from '../common/xmlrpc-client';
+
+const verifyCredentials = async ($: IGlobalVariable) => {
+  try {
+    await authenticate($);
+
+    await $.auth.set({
+      screenName: `${$.auth.data.email} @ ${$.auth.data.databaseName} - ${$.auth.data.host}`,
+    });
+  } catch (error) {
+    throw new Error('Failed while authorizing!');
+  }
+}
+
+export default verifyCredentials;

packages/backend/src/apps/odoo/common/xmlrpc-client.ts

@@ -0,0 +1,67 @@
+import { join } from 'node:path';
+import xmlrpc from 'xmlrpc';
+import { IGlobalVariable } from "@automatisch/types";
+
+type AsyncMethodCallPayload = {
+  method: string;
+  params: any[];
+  path?: string;
+}
+
+export const asyncMethodCall = async <T = number>($: IGlobalVariable, { method, params, path }: AsyncMethodCallPayload): Promise<T> => {
+  return new Promise(
+    (resolve, reject) => {
+      const client = getClient($, { path });
+
+      client.methodCall(
+        method,
+        params,
+        (error, response) => {
+          if (error != null) {
+            // something went wrong on the server side, display the error returned by Odoo
+            reject(error);
+          }
+
+          resolve(response);
+        }
+      )
+    }
+  );
+}
+
+export const getClient = ($: IGlobalVariable, { path = 'common' }) => {
+  const host = $.auth.data.host as string;
+  const port = Number($.auth.data.port as string);
+
+  return xmlrpc.createClient(
+    {
+      host,
+      port,
+      path: join('/xmlrpc/2', path),
+    }
+  );
+}
+
+export const authenticate = async ($: IGlobalVariable) => {
+  const uid = await asyncMethodCall(
+    $,
+    {
+      method: 'authenticate',
+      params: [
+        $.auth.data.databaseName,
+        $.auth.data.email,
+        $.auth.data.apiKey,
+        []
+      ]
+    }
+  );
+
+  if (!Number.isInteger(uid)) {
+    // failed to authenticate
+    throw new Error(
+      'Failed to connect to the Odoo server. Please, check the credentials!'
+    );
+  }
+
+  return uid;
+}

packages/backend/src/apps/odoo/index.ts

@@ -0,0 +1,16 @@
+import defineApp from '../../helpers/define-app';
+import auth from './auth';
+import actions from './actions';
+
+export default defineApp({
+  name: 'Odoo',
+  key: 'odoo',
+  iconUrl: '{BASE_URL}/apps/odoo/assets/favicon.svg',
+  authDocUrl: 'https://automatisch.io/docs/apps/odoo/connection',
+  supportsConnections: true,
+  baseUrl: 'https://odoo.com',
+  apiBaseUrl: '',
+  primaryColor: '9c5789',
+  auth,
+  actions
+});