n8n/packages/nodes-base/nodes/SendInBlue/SendInBlueTrigger.node.ts
brianinoa 74cedd94a8
feat(SendInBlue Node): Add SendInBlue Regular + Trigger Node (#3746)
* add sendinblue svg icon

* Add code and required files for new sendinblue node

* Add node to package.json

* Update credentials to display API Key instead of Access Token

* Use new svg found in brandfetch

*  Improvements

* ♻️ Moved descriptions for email to it's own file

*  Added support for contact get

*  moved email descriptions to it's own file

*  Add logic to conditionally remove/format sms,email

*  Improvements

*  Refactor Sender descriptions to it's own file

*  Fix urls

*  Improvements attempt

*  Refactor remove inline descriptions

*  Minor improvement

* 🎨 Learn a nice way to send options as key-value

*  Improvements

* ♻️ Fix Create Operation structure

* ♻️ Refactor create functionality for attribute

♻️ Introduce override for createAttribute selectedCategory

♻️ Add delete functionality

* 🔥 Remove preSend from delete

*  Implement override for body types

*  Cleanup node file

*  Update response for contact update
 Update request url for contact delete

*  Add presend check for optional properties that are empty
 Add Model file and TransactionalEmail interface

*  formatting

* ♻️ Remove requestOperations from Node Description level

* ♻️ Cleanup routing for Get All
♻️ Make Identifier required

*  Formatting

* ♻️ Add Options Collection

* ♻️ Add Filters area

* ♻️ Formatting

* ♻️ Handle empty return

* ♻️ Remove unused code

* ♻️ Fix pagination
♻️ Fix empty return for delete

*  Add pagination

*  Fix Modified Since

* ♻️ Reorder send operation ui

*  Remove no longer needed presend
 Add send html template operation

* ♻️ Make Contact Attribute name and type required

* ♻️ Rename Attribute to Contact Attribute

* ♻️ Rename Identifier to Contact Identifier

* ♻️ Remove SMS from root level because it can exist in Contact Attributes

* ♻️ Fix Array type using 'Array<T>'
♻️ Fix double quotes should be single quotes

* 👕 Lint Fix

*  Add email attachment functionality
 Add attachment data validation

*  Add dynamic loading of Email Template IDs

* ♻️ Cleanup validation method

*  Introduce workaround and use binary data for attachments

* feat: Migrated to npm release of riot-tmpl fork.

* 👕 Lint fix rules

* 👕 Lint fix rules

* fix: Updated imports to use @n8n_io/riot-tmpl

* fix: Fixed Logger.ts types.

*  Fix mixmatch of filename and package.json credentials list

*  fix mixmatch in nodes list

* feat(core): Give access to getBinaryDataBuffer in preSend method

*  clean up mixmatches in node naming

* ♻️ Refactor code to use newly exposed getBinaryDataBuffer method

*  Improvements

* 🔥 Remove unnecessary lines

* 👕 Fix linting issues

*  Fix issues with up to date APIs and improve readability

*  update naming of files

* ♻️ Move sendHtml boolean above subject
♻️ Update naming from Parameters to Fields

* ♻️ Move sendHtml boolean above subject
♻️ Update naming from Parameters to Fields

* ♻️ Add attribute name url encoding
♻️ Change limit's default to 50

*  Fix default for templateId

*  Fix display name for attribute list

* ♻️ Add clarity to attribute value display name

* ♻️ Add tags and attachments for emails

* ♻️ Add use of item's binary data fileName

* 👕 Fix action lint rule

* 👕 Remove deprecated lint rule

* ⬆️ Update eslint-plugin-n8n-nodes-base

* 👕 Fix lint rule for file name

*  Fix update attribute

* ♻️ Add upsert capabilites

* 🔥 Remove create or update operation

* ♻️ Add sendInBlueWebhookApi namespace

* ♻️ Add Webhook API functionality

*  Add SendInBlue Trigger

*  Return correct webhookId data

*  Add placeholder for receiving data

* 👕 Fixing existing linting issues

* 🚨 Enable namespacing in tslint file

* 👕 Fix linting issues

*  Rename exported WebhookApi

* 🔥 Remove unused Model.ts file

* ♻️ Update node to use SendInBlue namespace

*  Revert back to allowing upsert functionality

* ♻️ Fix options to better describe events

* Remove update flag for create operation

* ♻️ Fix discrepancies for contact resource

* remove no-namespace lint rule

* 👕 Fix linting issues

* ♻️ Add sendInBlueWebhookApi namespace

* ♻️ Add Webhook API functionality

*  Add SendInBlue Trigger

*  Return correct webhookId data

*  Add placeholder for receiving data

* 👕 Fix linting issues

*  Rename exported WebhookApi

* ♻️ Fix options to better describe events

* Add optionswithuri import that was lost

*  Fix details from janober's review

*  Fix order of displayName and name properties

*  Fix default value and improve loadOptions

*  Introduce support for comma separated attribute values

*  Introduce support for comma separated attribute values

* 👕 Fix linting issues

* Update defaults and required props

*  Fix copy paste issue Upsert was not using correct endpoint

*  Fix upsert email field display name

*  Last update, upsert email description

*  Add PostReceived type limit

Co-authored-by: ricardo <ricardoespinoza105@gmail.com>
Co-authored-by: Alex Grozav <alex@grozav.com>
Co-authored-by: Jan Oberhauser <jan.oberhauser@gmail.com>
2022-08-03 18:08:51 +02:00

294 lines
7.2 KiB
TypeScript

/* eslint-disable n8n-nodes-base/node-filename-against-convention */
import {
IDataObject,
IHookFunctions,
INodeType,
INodeTypeDescription,
IWebhookFunctions,
IWebhookResponseData,
NodeOperationError,
} from 'n8n-workflow';
import { SendInBlueWebhookApi } from './GenericFunctions';
export class SendInBlueTrigger implements INodeType {
description: INodeTypeDescription = {
credentials: [
{
name: 'sendInBlueApi',
required: true,
},
],
displayName: 'SendInBlue Trigger',
defaults: {
name: 'SendInBlue-Trigger',
color: '#044a75',
},
description: 'Starts the workflow when SendInBlue events occur',
group: ['trigger'],
icon: 'file:sendinblue.svg',
inputs: [],
name: 'sendInBlueTrigger',
outputs: ['main'],
version: 1,
webhooks: [
{
name: 'default',
httpMethod: 'POST',
responseMode: 'onReceived',
path: 'webhooks',
},
],
properties: [
{
default: 'transactional',
displayName: 'Resource',
name: 'type',
options: [
{ name: 'Inbound', value: 'inbound' },
{ name: 'Marketing', value: 'marketing' },
{ name: 'Transactional', value: 'transactional' },
],
required: true,
type: 'options',
},
{
displayName: 'Trigger On',
displayOptions: {
show: {
type: ['transactional'],
},
},
name: 'events',
placeholder: 'Add Event',
options: [
{
name: 'Email Blocked',
value: 'blocked',
description: 'Triggers when transactional email is blocked',
},
{
name: 'Email Clicked',
value: 'click',
description: 'Triggers when transactional email is clicked',
},
{
name: 'Email Deferred',
value: 'deferred',
description: 'Triggers when transactional email is deferred',
},
{
name: 'Email Delivered',
value: 'delivered',
description: 'Triggers when transactional email is delivered',
},
{
name: 'Email Hard Bounce',
value: 'hardBounce',
description: 'Triggers when transactional email is hard bounced',
},
{
name: 'Email Invalid',
value: 'invalid',
description: 'Triggers when transactional email is invalid',
},
{
name: 'Email Marked Spam',
value: 'spam',
description: 'Triggers when transactional email is set to spam',
},
{
name: 'Email Opened',
value: 'opened',
description: 'Triggers when transactional email is opened',
},
{
name: 'Email Sent',
value: 'request',
description: 'Triggers when transactional email is sent',
},
{
name: 'Email Soft-Bounce',
value: 'softBounce',
description: 'Triggers when transactional email is soft bounced',
},
{
name: 'Email Unique Open',
value: 'uniqueOpened',
description: 'Triggers when transactional email is unique opened',
},
{
name: 'Email Unsubscribed',
value: 'unsubscribed',
description: 'Triggers when transactional email is unsubscribed',
},
],
default: [],
required: true,
type: 'multiOptions',
},
{
displayName: 'Trigger On',
displayOptions: {
show: {
type: ['marketing'],
},
},
name: 'events',
placeholder: 'Add Event',
options: [
{
name: 'Marketing Email Clicked',
value: 'click',
description: 'Triggers when marketing email is clicked',
},
{
name: 'Marketing Email Delivered',
value: 'delivered',
description: 'Triggers when marketing email is delivered',
},
{
name: 'Marketing Email Hard Bounce',
value: 'hardBounce',
description: 'Triggers when marketing email is hard bounced',
},
{
name: 'Marketing Email List Addition',
value: 'listAddition',
description: 'Triggers when marketing email is clicked',
},
{
name: 'Marketing Email Opened',
value: 'opened',
description: 'Triggers when marketing email is opened',
},
{
name: 'Marketing Email Soft Bounce',
value: 'softBounce',
description: 'Triggers when marketing email is soft bounced',
},
{
name: 'Marketing Email Spam',
value: 'spam',
description: 'Triggers when marketing email is spam',
},
{
name: 'Marketing Email Unsubscribed',
value: 'unsubscribed',
description: 'Triggers when marketing email is unsubscribed',
},
],
default: [],
required: true,
type: 'multiOptions',
},
{
displayName: 'Trigger On',
displayOptions: {
show: {
type: ['inbound'],
},
},
name: 'events',
placeholder: 'Add Event',
options: [
{
name: 'Inbound Email Processed',
value: 'inboundEmailProcessed',
description: 'Triggers when inbound email is processed',
},
],
default: [],
required: true,
type: 'multiOptions',
},
],
};
// @ts-ignore (because of request)
webhookMethods = {
default: {
async checkExists(this: IHookFunctions): Promise<boolean> {
const webhookData = this.getWorkflowStaticData('node');
const webhookUrl = this.getNodeWebhookUrl('default') as string;
const type = this.getNodeParameter('type') as string;
const events = this.getNodeParameter('events') as string[];
try {
const { webhooks } = await SendInBlueWebhookApi.fetchWebhooks(this, type);
for (const webhook of webhooks) {
if (
webhook.type === type &&
webhook.events.every((event) => events.includes(event)) &&
webhookUrl === webhook.url
) {
webhookData.webhookId = webhook.id;
return true;
}
}
// If it did not error then the webhook exists
return false;
} catch (err) {
return false;
}
},
async create(this: IHookFunctions): Promise<boolean> {
const webhookData = this.getWorkflowStaticData('node');
const webhookUrl = this.getNodeWebhookUrl('default') as string;
const type = this.getNodeParameter('type') as string;
const events = this.getNodeParameter('events') as string[];
const responseData = await SendInBlueWebhookApi.createWebHook(
this,
type,
events,
webhookUrl,
);
if (responseData === undefined || responseData.id === undefined) {
// Required data is missing so was not successful
return false;
}
webhookData.webhookId = responseData.id;
return true;
},
async delete(this: IHookFunctions): Promise<boolean> {
const webhookData = this.getWorkflowStaticData('node');
if (webhookData.webhookId !== undefined) {
try {
await SendInBlueWebhookApi.deleteWebhook(this, webhookData.webhookId as string);
} catch (error) {
return false;
}
// Remove from the static workflow data so that it is clear
// that no webhooks are registred anymore
delete webhookData.webhookId;
delete webhookData.webhookEvents;
delete webhookData.hookSecret;
}
return true;
},
},
};
async webhook(this: IWebhookFunctions): Promise<IWebhookResponseData> {
// The data to return and so start the workflow with
const bodyData = this.getBodyData() as IDataObject;
return {
workflowData: [this.helpers.returnJsonArray(bodyData)],
};
}
}